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Customer Licensii^ Agreement 



The Roger Wagner Publishing, Inc. software product that you have just 
received from Roger Wagner Publishing, Inc., or one of its authorized 
dealers, is provided to you subject to the Terms and Conditions of the 
Software Custon^ Licensing Agreement Should you decide that you 
cannot accept these Terms and Conditions, then you must return your 
product with all docunaentation and this License marked "REFUSED" 
within the 30 day examination period following the receipt of the product. 

1. License. Roger Wagna* Publishing, Inc. hereby grants you upon your 
receipt of this product, a nonexclusive license to use the enclosed Roger 
Wagner Publishmg, Inc. product subject to the terms and restrictions set 
forth in this License Agreement 

2. Copyright. This software product, and its documentation, is 
copyri^ted by Roger Wagner Publishing, Inc., with all rights reserved. 
You may not copy or otherwise reproduce the product or any part of it 
except as expressly permitted in this license. 

3. Restrictions on Use and Transfer. The original and any backup copies 
of this product are intended for your personal use in coni^tion with no 
more than two computers. You may not sell or transfer copies of, or any 
part of, this product, nor rent or lease to others without the express written 
permission of Roger Wagner Publishing, Inc. 



Limitations of Warranties and Liability 

Roger Wagner Publishing, Inc. and the program author shall have no 
liability or responsibility to purchaser or any other person or entity with 
respect to liability, loss or damage caused or alleged to be caused directly or 
indirectly by this software, including, but not limited to any interruption of 
service, loss of business or anticipatory profits or consequential damages 
resulting from the use or operation of this software. Some states do not 
allow the exclusion or limitation of implied warranties or liability for 
incidental or consequential damages, so the above limitation or exclusion 
may not apply to you. 



ProDOS and Apple II DeskTop are copyrighted programs of Apple 
Computer, Inc. licensed to Roger Wagner Publishing, Inc. to distribute for 
use only in combination with SoftSwitch. 

APPLE COMPUTER, INC. MAKES NO WARRANTIES, EITHER 
EXPRESS OR MPUED, REGARDING THE ENCLOSED COMPUTER 
SOFTWARE PACKAGE, ITS MERCHANTABILITY OR ITS FITNESS 
FOR ANY PARTICULAR PURPOSE. THE EXCLUSION OF IMPUED 
WARRANTIES IS NOT PERMITTED BY SOME STATES. THE ABOVE 
EXCLUSION MAY NOT APPLY TO YOU. THIS WARRANTY 
PROVIDES YOU WITH SPECIFIC LEGAL RIGHTS. THERE MAY BE 
OTHER RIGHTS THAT YOU MAY HAVE WHICH VARY FROM 
STATE TO STATE. 



The SoftSwitch documentation and software are copyrighted © 1987 by 
Roger Wagner Publishing, Inc., all rights are reserved. This documentation 
and/or software, or any part thereof, may not be repnxiuced in any form or 
by any means, electronic or mechanical, including photocopying, recording, 
storage in an information retrieval system, or otherwise, without the prior 
written permission of the publisher. 

Tass Times in Tonetown, PaintWoiks Plus, Shanghai and Music Studio aie trademarics 
of Activision, Inc. 

Apple, DOS 3.3, ProEJOS, Mousd^aint, Program Launcter, AppleWorks and Apple II 

DeskTop are trademarks of A]^le Corr^ter, Inc. 
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Corrqsanion are trademarks of Broderfound Software, Inc. 
Blazing Paddles, Pixit, Prince and 816^aint are tractemarks of Baudville, Inc. 
Music Construction Set is a trademark of Electronic Arts, Inc. 
F15 Slrike Eagle is a trademark of MicroProse, Inc. 

The Complete GmpMcs Syston and The Gr^Mcs Magician are trademarks of 
Polarware, Inc. 

SoftSwitch, MouseWrite and Printographer are trademarks of Roger Wagner 
Publishing, Inc. 

Graphics Expander and Newsroom are trademarks of Springboard, Inc. 
Flight Simulator is a trai^nark of SubLogic, be. 



OUR GUARANTEE 

This product carries the unconditional guarantee of satisfaction or your 
money back. Any product may be retumed to place of purchase for 
complete refund or replacement within thirty (30) days of purchase if 
a(x:ompanied by the sales receipt or other proof of purchase. 
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:er 1: Introduction 



Wdcome 10 SoftSwildit a pfogram designed specifically to take advantage 
of OieextmmeDuryinyoiirA^leUG^^ Inu^g^iebeiiigdite 
betwemSnnintiigimgraimwiiiijustakeys^^ Imagine bdoig able to 
revcit to a previous state of a given pn3graiiL Imagine interrupting a 
program at aay instant, savii^ the program to dis^ 
tbenii^iiimpgtolliatexacApoiEitwe^ Imagine aUdus and mon^ and 
youte beginning 10 iinderst^ die iKmer of S 

SofiSwilch IS impleniented a$ a Classic Dkesk Accessory on the Apple IIGS. 
Ibis means that it is available at any ilae by piessing the Cm 
Ap^Eacape sequence Ibat is used to access die nC^ Dts^ 
MentL 

WbenSoftSwitdi is pot on yrar System Disk, il is anlin^ 
when PfoDOS 16 is started, and the name "SoftS witch" will i^pear in the 
Desk Accessory Menu along with "Contiol Pand, Alternate Di^lay Mode,'' 
and whatever odier DedL Accessofks may be presem m the OS. 

The primary purpose of SoftS witch is to allow you to install up to three 
separate, hxl ccHKurrent, {HOgrams, and to be able 10 swildi between these 
applications as siiiq)ly and quiddy as possible. 

To load or switch applications, and to perform other SoASwitch furnrtionst 
you must be able to access the Desk Accessory Menu by pressing Contiol- 
Opeii-Aiq>le-Escq>e while you are using your progranL ^ die program doc^ 
noi allow access to die Desk Accessctfy Mom, dKQ it caniK>t be u^ 
SoASwildL 



The SaftSwUch Display Screen 



Wheal Softswitch is first a^vated by setecting it ttom die De^ Accessory 
Menu, the SoftS witch Dis[day Scaeeii dppcms. The display is made of 
the following elements: 



Auto-Save Status 

Time of Current 
Program Suspension 

Stored ,„„ 



Workspace #8 



Time of Program, 
Suspensions 



Mini-Smmn image ^. . n 

of Suspended Pn^ Memory Status Box 
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An Overview 

The general overview of SofkSwiicht and die purpose of the VMious 
displays is as follows: 

When Softswitch is first entered, the program that has just been interrupted 
is indicated by a Mini-Scieen in the upper ceiuer of the SoftSwiich screen 
display. TheMim'^ScfeeaisaaxnpressedieiididQnof thedisp 
acdve at die mom^ thepog^un's (^»eiadoii was suqiended. 

To die Icfit* ifae date and time of the ucact inomem of suq)^^ 



To the right, the Memory Status Box shows the total memory available in 
your Ai^le UGS, how much is currently available foruse* «^ how much 
mraiocy is connidy in use sioffiiig pi^^ 

Hie three bosses labeled "Wmfcspace 1, 2 & 3" are like stoiage hk^ for die 

image of a suspended piograrrL Right now, these storage areas hold 
nothing, but in a mofnent* well ^ 
imgram diat can be switdied by Softswitch. 

To use Softswitch, programs must first be run, and then interrupted. Then 
an image of that program must be stored in one of the Woikspaces* The 
process is thra rq>eated for each successive pn)gram uiitil the desired 
nutnlw of Woikspaocs have been assigned stored programs. Once 
SoftSwildi has stoced die programs, you can switch between psogpaass al 
will 

SoftSwilch has very few command keys. The primary commands use the 
number keys l,2and3, SoftSwitchis "context sensidve/* which means 
that it can tell what you want to do by the context of when a command key is 
prised. For example, if you enter SoftSwildi and picss die OHiespoi^^ 
key nurribcrforan CTipty Workspace, SoftSwitdi assumes you want to 
store a copy of the program in that Workspace. However, if the Workspace 
you choose is not empty* SoftSwitch assumes you want to switch to die 
pcpgram fdready stored in diat WcHkspace. 

While the SoftSwitch display screen is visible, a Workspace area can be 
cleared atar^tiniebypfessingdieOprarApplekey anddiecone^IK^^ 
number key. 



Uses For SoftSwitch 

lliere are niany di^ei^ ways of iisiQg Sofifi witdL The for^ 
categories are: 

1) Program switching is the most obvious use. You can quickly go from 
one program to anodier aiKl back at will, eliminating any wasted time 
quitdiv exie laogEam and waidi^ for die neict 10 lo^ 



2) Softs witch has a provision for copying any program display screen or 
stored graphic image from one program to another. For example, this 
"copy & paste" feature lets you transfer a Hi-Res graphics picture from 
one program where it was created, to another for printing, editing, or 
saving to disk. The two programs can be protected or not, and the 
transfer takes only seconds. Best of all, the two programs don't even 
need to run under the same disk operating system. Thus you can quickly 
transfer a ProDOS Hi-Res picture to a DOS 3.3 program, or vice versa. 

3) You can use SoftS witch to "revert" to the state of an application, or the 
^itire computer, at some previous point in time. 

Tte simplest application of this idea is with the Apple DeskTop program. 
Ordinarily, it takes quite some time to retum to the DeskTop whai you 
quit a program started from it By storing it in one of the Work^aces, 
you can switch back instandy to the DeskTop environment, ready to run 
the next program. 

The second variation on this theme is to revert a specific application to 
where it was at an eariier point in tin^. For exan^le, tmst drawing 
programs with an "undo" feature limit you to only cancelling the very last 
action. With SoftS witch, you could revert to the the way the drawing 
miS some minutes before. 

4) You can use Keq>sake, a separate program supplied on tte SoftSwitch 
diskette, to save om or more of tte currmtly switching applications to 
disk. Thus, you can suspaid a program's operation over any period of 
tin^, and then resume tte program exacdy where you left off many days 
later. 

The design of SoftSwitch has created an almost endless variety of possible 
uses: 

a) Applications Extensions: Do you sometimes wish that the program 
you're running had the functions of some other program? For example, if 
you're using MousePaint, you may wish you could format a disk, or copy 
files as you can with tte Apple 11 DeskTop program. With SoftSwitch, the 
DeskTop could be stored in a Workspace, and thai you could switch 
wteiever you i^eded to use any of the disk operations not available in 
MousePaint. This principle applies to any combination of complementary 
programs that you can imagine. 



^^^^^ 



b) Multiple Users on a Single Machine: In an office equipped with 
only one IIGS, occasionally youte forced to save what you're working on 
and quit your program because another person has to use tte IIGS for a 
nK>re urgent task. With SoftSwitch, you can save your application in a 
Workspace, and Umi let the otl^r person run another application. When the 
other person is finished, your application is restored ii^tantly, and at the 
exact point wtere it was interrupted. 

c) Adventure games: Many games take quite a long time to get to a certain 
point in the program. If your "character" should then perish, you have to 
start over. With SoftSwitch, you can save the state of an adventure game 
ji^t prior to any hazardous encounter. Thm, if your charactCT succeeds, 
you can update the stored game with SoftSwitch. Howevo", if your 
character perishes, you can revert to tte state of the game just prior to the 
hazard, ainl try again, wittK)ut having to re-run the entire program. 
SoftSwitch's Keepsake program also saves su^nded state of the pme 
to disk. This is particularly haiKiy for those programs that do not offer a 
save option. 

d) Arcade games: Similar to tl^ benefits to Adventure games, arcade 
gan^s can be saved with Keepsake whenever you attain various high score 
situations. Thus you can always return to a level of success for another try 
without replaying the entire game. For example, in F15 Strike Eagle, you 
can make unlimited tries at landings and otho* maneuva*s without repeating 
the beginning of the flight Since iK>t all entataimx^t programs let you 
save the current state of the ^n^ to disk, you may find Keepsake's save-to- 
didc feature handy for these as well. 

e) Ddn^giiig: As a irogramming utility, SoftSwitch lets you freeze the 
pn^ram stale at any point Then the problon area of the program can be 
rqieated over and over without a fatal system crash, because die "good" 
spiem can always be restored. Utilitks may also be developed for 
SoftSwitch in the foture diat will allow pogrammo^ to compare programs 
at different times of operatioii, examine memcMry "snapshots," and more. 

f) Documentation iUustratMins: Because SoftSwitch can "capture" any 
Hi-Res, Double Hi-Res, 40 cmt 80 column saeai, it can be u^ to copy and 
printany screen from a ruiining program without disturbing it Thus 
anyone who creates written explanations of any software piK^kage (authors, 
teachers, consultants, etc.) can use SoftSwitch to put perfect "screen shots" 
in any printed material. Appendix E has more information about this. 




g) Software demonstratioiis: Anyone who demonstrates software to 
others (teachers, consultants, user group presenters, deala*s, technical 
support personi^l, etc.) can use SoftS witch to quickly switch between 
several diffoent programs without having to restart die machine. A great 
time-saver. 



Softswitch Requirements 

Softswitch requires an Apple IIGS, a RAM Expansion Card with a 
minimum of 5 12K on it, and a 3.5" disk drive. 

Softswitch stores and switches applications ufwia* ProDOS 8, DOS 3.3, 
and other nKKiifications of tl^se operating systons as long as the Desk 
Accessory Menu im mi been disabled by the applicatioa 

Softswitch does not switch ProDOS 16 applications. Most current ProDOS 
16 applications such as PaintWorks Plus, Music Studio and others, require 
a RAM Expansion Card of at least 512K. Thus, there is not enough room 
in msnrny to have two or more of ttese applications and SoftSwitch in the 
IIGS at d^ san^ time. It is possible that, as largo* RAM Expansion Cards 
become available, a version of SoftSwitch will be designed to switch 
between ttese ptog^mm also. 

Programs which use ProDOS 1. 1.1 present a diffeim iwoblem. ProDOS 
1.1.1 turns off iittatnq)ts, aiKl dius pevoits iKxess to the Desk Accessory 
Menu. Fortunately, most pograms opermng uncter BroDOS 1.1.1 can be 
started from a Program Sdector sudi as the DeskTop. Using the D^kTop 
causes these programs to be started with ProDOS 8 instead, thus bypassing 
the ProIX)S 1.1.1 that may be on the program disk. You can also use the 
DeskTop to rqjlace d^ older ProDOS 1.1.1 on die disk widi ProDOS 8. In 
addition, programs under ProDOS 1.1.1 diat use tte momc (such as Etazzle 
Draw) automatically enable intmupts, and thus allow access to die Desk 
Accessory Mem. Most mouse-based progr^ns will work widi SoftSwitch, 
regardless of which DOS d^y use. 




Chapter 2: Installation 



Setting the RAM Disk 

Before installing SoftSwitch, make sure that your Control Panel setting for 
the RAM Disk provides enough memory for SoftSwitch. As nientioned 
before^ you must have at least S12K RAM on your RAM Expansion Card in 
additifm to die 2S6K standaid mmic^ 

WIkb setting the RAM I>isk values in the Oootrol Pand oo your Appte 
BGS, it is inqxxtam to undefstand that you are divi^^ 
of mmiory betmm two distinct systems dial 




As you make your RAM Dtdc size larger, the anio^ 
for Softswitch, aiKl any other program that uses die syst^ memory for 
piograiDS, as opposed to a RAM Disk device* gets snaller. Ukewisetas 
yoa make die RAM Disk smaller^ die amount of system memory inc^^ 

If yoa do not have any programs which lequixe the RAM Expansion Card 
OOoQgniediStRAM Disk, you may just set tfaeRAM Disk size to OK^ If 
yoii lie ittiqg a fvovam sudi as MbuseWrite diat can 1^ 
win have to dedde how you warn to paititioii memory , 

If you are not suic bow 10 use die CoDtiol Panel to Ghai^ 
settings, see Appendix At niie Ctaoiiol Tteid Ttogv^ 
Owncf^ Guide. 




Here are son^ suggested settings for diffoent RAM Expansion Card sizes 
and progiam use: 

RAM Expansion Minimum Maximum Mmioiy Available 
Card Size Setting Setting for SoftSwitch 

OK OK OK OK 

IMPORTANT: This is not large eiKJugh to use eitte" SoftSwitch or a 
RAM Disk. 



RAM Expansion Minimum Maximum Memory AvaQable 
Card Size Setting Setting for SoftSwitch 

256K OK OK 256K 

With this setting, you can only store 1 program in a SoftSwitch Woikspace 
for reverting. True switching is mi possible with this setting. 

If you want to use the RAM Disk for some specific purpose lata* on, you 
can re-configuie the Control Pai^l tmqx>rarily for the task, and tbm set the 
RAM Disk back to OK whm you're done. 

If you only have 256K Expansion RAM, we recommend you set your RAM 
D^c to OK for the tin^ bedng, and think smoudy about tniying more RAM 
10 expaml your RAM card. 



RAM Expansion Minimum Maximum Memory AvaOable 
Card Size Settii^ Setting for Softswitch 

512K OK OK 512K 



If you're using the DeskTop to start programs, 512K is the minimum 
amouitt of RAM Expansion monory ne^ed to switch three programs. 




Here are some suggested settings for Mf&tmt RAM Expansion Card stz&s 
and program use: 

RAM Expansion Minimum Maximum Manory Available 
CardSi2» Setting Setting for SoftSwitch 

OK OK OK OK 

IMPORTANT: This is not large enough to use eitl^ SoftSwitch or a 
RAMDislc. 



RAM Expansion Minimum Maximum Memory Available 
Card Size Setting Setting for SoftSwitch 

256K OK OK 256K 

With this setting, you can only store 1 program in a SoftSwitch Woikspace 
for reverting. Tme switching is not possible with this setting. 

If you warn to use tl^ RAM Disk for some specific purpose lata* on, you 
can re-configure tte Control Pai^ tOTqx)rarily for the task, and ihsa set the 
RAM Disk back to OK when you're done. 

If you only have 256K Expansion RAM, we recommeiMi you set your RAM 
D^ to OK for the time bdng, and think seriouMy about Iniying more RAM 
to expaiMl your RAM card. 



RAM Expansion Minimum Maximum Memory Available 
Card Size Setting Setting for SoftSwitch 

512K OK OK 512K 

If you*re using tkm DeskTop to start programs, 512K is the minimum 
amount of RAM Expansion mraiory needed to switch three programs. 



1 



If you're using tte Program Launcher with a 5 12K RAM Expansion Card, 
you'll only be able to store and switch two programs. This is because the 
Program Launcher uses much more n^nory than the DeskTop. In order to 
switch three programs with the Program Lauicher, you need a niinimum of 
768K on the RAM Expansion Card. 



RAM Expansion Minimum Maximum Memory Available 

Card Size Setting Setting for SoftSwitch 

1Mb 512K 512K 512K 

L5Mb 512K 512K 1Mb 



Remember that after you have made the impropriate changes to tbe RAM 
Disk s^tinp, and you have pressed Retum to accept the settings, you still 
mast Quit the Control Panel and turn the power completely off on the IIGS. 
Then, when you turn die power back on, the new RAM Disk settings will 
be ineffDCL 

We i gc omm e nd that you set bodi the maxinnmi and minimum values for the 
RAM Disk to die same value. The ability to use a minimum and maximum 
value inqilies that lii»e is SQine usefulness to doing it The reality is that 
some Appte IIGS programs will sinq)ly crash when they starting fighting 
over the use of the uidefined area cmattd by differing minimuroAnaximum 
values. This is iK)t tl^ fault of the software, but an inl^rant problem in the 
implemaitation of the minimum/maximum design. We recommend you 
always keep the values the same. 




Installing SoftSwitch 



SoftSwitch may be installed on other diskettes in addition to the disk 
included in the SoftSwitch package. This section describes how to put 
SoftSwitch on other diskettes. If you would like to go directly to the next 
Chapter, "Starting With SoftSwitch", and try the examples on using 
SoftSwitch, you may skip this section for the time being. This section is 
only required if you should want to start up your Apple IIGS from another 
disk, such as a hard disk, or other ProDOS 16 System Disk. 

9ie sit sfc s{e 3ie 

The SS.SYSTEM.DISK includes a program to transfer SoftSwitch to any 
PioDOS disk that contains the usual SYSTEM files, such as the 
SYSTEM.DISK that can^ with your Apple IIGS, or any ProDOS 16 disk 
with a SYSTEM folder, including hard disks. 

Eventually, you may want to install SoftSwitch on another diskette for your 
daily use, and keep the SS .S YSTEM.DISK in a safe place for future use. 

SoftSwitch can only be installed on disks that start up in ProDOS 16. It can 
not be installed on a ProDOS 8, PioDOS 1.1.1, or DOS 3.3 diskette. If 
you are unsure of a particular diskette, just start it and see if the very first 
screen that appears says "ProDOS 16." 

During the ins^ation of SoftSwitch, you must know the volume name of 
the disk you want to put SoftSwitch on. This can be determined by just 
looking at the name of the disk icon on the Apple II DeskTop before you run 
the Install program. For this example you will be installing SoftSwitch on 
the SS.SYSTEM DISK first 

To install SoftSwitch on the SS.SYSTEM.DISK: 

1) Start up on the disk from a cold start as you would any 3.5 disk. When 
the SoftSwitch title screen appears, press Retum to go to the DeskTop. 

2) When the DeskTop and menu bar at the top of the screen appears, use 
the mouse pointer to select the "Selector" menu, and choose "Install SS" 
from the menu list 



3} Aftef a mamentt the Install dispUQ^ screen will appear. 



nstall 



1. InsUll Cof^y SoftSiiitch to P-cDOS 16 disk. 

2. Rewcwe Celete SoftSuitch frjr ProDOS IS disk. 

3. Quit Exit tha iitst^Ualio^ proflrss. 



Ill 



.IHiL'.-i:!!:!.:. 




frns t key for your choi«. 
item or fi to quit. 



The dialog box at ihe bottom proii^ "Press number key for your choice.' 
4) Press 1 to begin the instaUatuxt 



"Install" is highlighted and the prompt "Enter target volume 
SoftSwitch" afjpears in the dialog box at the bottom. 



for 



5) Type SS.SYSTEM.DISK and press Return at the "New Disk Prefix;" 
jmnpL If you were usirig a differeot disk, you would type its volume 
name for example "HARDl" fcr al^ disk. 

The dialog box then prompts "Insert target disk volunte, then press Return 
to continue os Escape lo cancel" Since the SS.SYSTEM.DISK is already 
in tbe drive, press Retum to begin the instaUatioiL If youhadadiffeient 
disk, you would insert at dus point, and [sess Retiint 




The hourglass tt^ appeals for a few nvmiefits. Hnally, the oiigiiial Lostall 
display soeen qqjeais. 

Tbat's all there is to iti SofkSwitdi is riowpcioperly installed ofifliesi^^ 
SS^YSTEMLDISK 

To return to the DeskTop, press '^3" (to Quit). This wiU quit Ibe Install 
prognimaiid gohack to the De^Top. 

At this point you may wish to check your new disk installation by doing a 

cold startup of the disk, and verifying dial SoftSwitdi af^yeais in the Desk 

AccesscHy MemL Whm the dsk has started, press Coiitco^^ 

Escape to go to the Desk Accesscny Menu. You should see "SoftSwitch" in 

tIi&D^AccessoryMeim(5ee illustration, page IS). If it is not there^ 

letnm to step 1 in the Tw^ltoiion pfoc^uzes and carefully lepeal the 

proc^. 

Once SoftSwitch appears in ihe Desk Accessory Mam, you do not have to 
repeat the Installation |m)cess unless you warn to add Sk)ftSwitch to a new 
dislcetle. 



Additional Installations 



You caause the SS.SYSTEM.DISK to put SoftS witch on any RroDOS 16 
fbfmatted diskette* 

You should not attenqjt to install SoftS witch on copy-protected disks* 
regardless of their operating systems. Instead, start up your 
SS.SYSTEM.DISK Hrsl, and then run the .SYSTEM file for the desired 
program. This should not be a problem since any disk that can be "opened" 
on the DeskTqp can be nmdiiecdyfinim there, wUIk^ 
disk itself. 

If you cannot "open'' a DOS 33 or protected ProDOS disk, you can use the 
Startup menu in the DeskTop. These DeskTop techniques are covered in 
detail in the donoostrations which follow. 

If you intend to use SoftS witch with a second computer, you should use the 
backup copy of SS.S YSTEM.DISK. You can receive your free backiqj 
copy by returning the Sof tSwitch Registiation Card included in the 
ScitS witch package Retumiog ihis card also hdf^ us iK)tify you ab^ 
updates to SoftSwitch and aiiitles you to ledmical si^port. 

To install SoftSwitch with a second computer, use the backup disk to re- 
install Softswitch on the SS.SYSTEM.DISK any other S YSTEM.DISK 
you wish. During tte installation, SoftSwitch wiD be added to the D^ 
Accessmy Menu on that conqmter. 

Softswitch will now appear in the Desk Accessory Meim on either computer 
whether you are using the SS,SYSTEM.DISK or any oth^ disk with 
SoftSwitch installed on it. 

If you intend to use SoftSwitch in an office, school or odier nuilti-comput^ 
enviioninent, you may buy one additional cq^ of SofSm 
of computes you wish to use SoftSwitch on. 

The SS,SYSTEM-DISK included in the SoftSwitch packag?© may be used to 

demonstrate SoftSwitch on any Apple lIGS at any time, and we welcome 
your interest in sharing your enthusiasm (though not the software) with 
your bkmds and associates. We have gone to extensive lengths to provide 
an easy to use, yet iruly useful product for your at a reasonable cost We 
appreciate your support 



Putting DeskTop on Your Own System.Disks 



If you would like to modify your existing S YSTEM.DISK or hard disk to 
startup (boot) directly into the DeskTop, simply use the DeskTop to copy 
the file START from the SYSTEM folder on the SS.SYSTEM.DISK disk to 
the SYSTEM folder on the destination disk. You also need to copy the file 
DESKT0P.SYS16 and the DESKTOP folder to the root directory of the 
destination volume. 

Be sure you have also installed SoftSv^tch itself on the SYSTEM.DISK 
using Install as described in this chapter. 

For more information on using the DeskTop program, see the Apple IIGS 
Users Guide. 



Removing SoftSwitch 

There may be an occasion (we can't think of any) when you want to remove 
SoftSwitch from a diskette. The procedure is virtually the same as installing 
SoftSwitch, except you begin by pressing item number 2 from the Install 
display screen. 



Quitting Install 

This is simple eiK)ugh, Just press item number 3 from tte Install display 
screen to exit tte program. This will return you to the DeskTop. 

Now that you have successfully installed SoftSwitch on the 
SS.SYSTEM.DISK, it's time to see it in action with some of the 
demonstration programs provided on that diskette. 



Chapter 3: Starting with SoftSwitch 



For being deceptively simple in concept, SoftSwitch has many different 
possible uses. This is because it "works" only by enhancing other pieces of 
Apple software. Since there are thousands of different programs that run on 
the Apple IIGS, there are thousands of ways to use SoftSwitch. 

To make learning about SoftSwitch as easy as possible, we're going to lead 
you through a variety of scenarios for using SoftSwitch, and the exact steps 
needed to start and store a variety of different programs. 

Keep in mind that none of these is the way to use SoftSwitch. After 
becoming familiar with the many options available from within SoftSwitch, 
you can decide which way of using it best suits a given task. 

All of the examples that follow use files provided on the disk named 
/SS.SYSTEM.DISK that came in the SoftSwitch package, and onto which 
you have already installed SoftSwitch. If you're reading ahead and you 
have not installeid SoftSwitch or changed the RAM Disk settings, please go 
back to die sectkm entitled "Installing SoftSwitch" before proceeding with 
the exan^Ies. 

The ^S.SYSTEM.DISK in the SoftSwitch p^kage is a little different from 
the one provided by Apple Computer with your IIGS in that it starts by 
going directly to tbs Apple 11 DeskTop program. 

The advantage of this setup is both a faster startup time, and also the saving 
of system memory for SoftSwitch applications by avoiding the use of the 
Program Launcher. 

Although these first examples will use the Apple II DeskTop to start up the 
various demonstration programs switched by SoftSwitch, die DeskTop, as 
such, is not reqiured. 



Example #1: Speeding Up the DeskTop 



The siniplest use of Softswitch is to quickly leven tte 
previous poini in time. Agoodusefi^ diisa{»Qtykloiiistantfy 
the Apple n DeskTop after running a program. This gives a tremendous 
time savings when running new programs. 

To see how Ihis is done, place ite /SS^SYSTEMDISK (with SoftSwitch 
already installed) in the 3*5 startup drive and turn on your IIGS. 

After a moment, a title screen will appear. I^ress Return to start up tbe 
Ai^n DeskTop. If youev^wish^log^to BASICSYSTEMquiddy, 
you can also press die Esc^ m this titte scieeri, and dEq> ^ 
entirely. 

When the DeskTop is di^layed, it should look something like iim: 
4 Fit fa Stvt^ SMir 



Now l^'snm a program. Running a iHOgram using ifae DeskTop is done 
by fu^i using the mou^ to click on the icon of the disk that has the pro^m 
of interest on iL 

Click once on the SS.S YSTEMDISK icon now. 





The icon will be darkened, showing it's selected. Now double-click to 
"open" the disk to see what is on it 

To run a program from the opened disk, you would rq)eat the procedure of 
clicking once to select the program, and then double-clicking to run it. 

When you click to open SS.SYSTEM.DISK, one of the program icons you 
can see is called "Sweeper." 

Click once to select Sweeper. 



i Fite Ifei Special Starhy Stitdif 




If the program you wanted to run was not immediately visible, you can use 
the up and down scroll arrows to see other files on the disk. 

Double-click to run Sweepa* now. 



Sweepo" is a Hi-Res program that draws interesting patterns on the screen. 
After watching a few patterns, press Retum to Quit die program. When you 
do, the program wiU stop and automatically retum to the Apple II DeskTop. 




If you're like iiK)st people, you may think the DeskTop takes a little too long 
to stmt back up. Because of this, mmy people decide to stop using the 
DeskTop, and just press RESET to run arotho" progranL With SoftSwitch, 
you can have tli^ best of all worlds: Easy program selection and a fast 
return to the DedcTop. 

Let's take a look at SoftSwitch now. First, well store the state of the IIGS 
at this moment Then youll leam how to use SoftSwitch to "revert" back to 
this moment after you've run a program. 

Press Control-Open-Apple-Eso^ to go to the Desk Accessory Mmn. 

This is tte smm key sequence you me^ to go to the Cbittrol Panel to set your 
system preferences. Howev^, this time youll be selecting SoftSwitch 
instead. If you've installed SoftSwitch correctly, you should now see its 
nan^ in tte list of Desk Accessories, like fliis: 



ia ii4.-ji:imi{.u t i i 



Control Panel 
Alternate Display Hode 
SoftSuitch 
Quit 



Select It Open= ♦! 



Use the arrow keys to select SoftSwitch and press Return. 



When yoii dOt the foUowiiig screen ^ 




Notice ibat die Active Woikspace conmins a Mini-Smen i&pmeata&m of 
ihe DeskTop progpna TUs was the program that was naming wh^ 
diose SbOShrilck Yimll begin by siK^^ 
in Woricspacc #1. 

Press die (for Wcxkqiaoetl) key now. 

Immediately, youU see a copy of the active Mini-Screen placed in the 
WoricqMioe #1 di^lay screen. This shows that SoftS witch has just stozed 
an exact inMige of your progiam, in this cas^ 
Woikspacew Yoa can al»» see it has added the tmieMwfakiidiat save 
place. Ite our example, well say diattbie was 4:30 FMmO^ 

Now diat a iHoginam has been sicned in Wcdcqiace #1 , 1^^ 
active program. 

Piess die Return key (or Escqie) In exit Sc^wil^ 
Hiis will return you to tte Desk Accessory Menu. 
Pkcss Return to go bock to the DeskTop ("(Juit"). 



That was easy eoougli. Now)e^5nmdledemoIlstFatilmIm>g^nnaga^ 
DouMe dkdc cm die SS^SYSTEMDISfC ioxL 
Double click on Sweq^er to run it again. 

After Sweq)er is nnuung, let's suppos e you Ve decided it's time to run 
anofliw program. DO NOT QUTT SWEEPER. Iliis would force you to 
wait while the DeskTop program is loaded again. Since you already have 
storcd the DeskTop in Workspace #U you can use SoftSwitch to eliminate 
the delay in loading die DeslcTcq) apin. 

Press Control^^pen-Apple-Escape lo go to the Desk Accessory Menu, 
Use the anow keys to select SoftSwitch and press Retuia 



F ^ ■ ^ 
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In the Active Workspace is die Sweepo- program widi its Hi-R^ In 
W<xkspace #1 is die DeskTop as il was safml at 4:^ 

You warn to rqilace die Active prpgi^ 
in WoAspacc #1 (DeskTop). 



Pkess the "r key now. 



Sof^ witch prompts you with "If you switch now, you will lose the current 
application. Press 'Y to proceed." 

SoftSwitch is reminding you that if you revert the computer back to the way 
it was 5 minutes ago, you'll lose what you've got right now. In this 
example, that is exactly what you want to do. 

Press "Y" to confirm. 

The Active Workspace Mini-Screen changes to match Workspace #1. The 
reversion is now complete. 

Press Retum to exit SoftSwitch, and Return once more. 

You are back in the DeskTop! This process is called "revming," and can be 
used whenever you want to revert a computer program back to where it was 
at an earlier moment in time. Obviously, to make this work, you must first 
save an image of that program within SoftSwitch at the point you'll want to 
return to later. 

The firsi tkiie tfaioa^ this may semi a little more complicated than letting 
^ DeskTcqi lun autmnatk^y when you quit a program. However, you'll 
soon get the hang of revming to the De^Top in just seconds, instead of 
waiting for flie DeskTop to re-install itself each time you quit a program. 

Try this process on your own now by running Sweeper again from the 
DeskTop and then using SoftSwitch to retum to the DeskTop. You don't 
need to save the DeskTop again in Workspace #1 since it's already stored 
there. 

Note: For a complete discussion of the Apple II DeskTop program, see 
Chapter 2 of your "Apple IIGS System Disk User's Guide" that came with 
your Apple IIGS. 



Example §2: Reverting a Single Program 



A variation on levertipg to DeskTop is to use another Woikspace to save 

a copy of die pn?gW3^ yoate niDoii^ so that 

stale. 

This time, well use the "Draw It" demonstration progrant Instead of 
sdecting it fam an opened disk icoo, see 1k)w touse ihe "Sekdor" 
function of tte DeskTop. 

If you use the mouse to pull down the Selector menu, youll see that the 
sample pmgraim used iaibesedeiiioiistmtioiis have alieady enteied 
into the Selector menu. To run any program you just press and hold down 
the mouse button as you drag the mouse down the menu to select the desired 
piogvam. Then ickase the nxRise buttim to run ibe proigiaiEL 









Add M Eitfi . 






























Select and nm Diaw It from die Selectm menu now. 

b a moment a screen of instructions will appear. This program uses die 
mouse and pre-drawn shapes to help you create a Hi-Res picture. It is not 
intended to be a sophisticated program (althou^ you*ie welcome to 
experiinent with it), but ladior an exanqile of the ^pe 
use with SoftSwit^ such as Dazzle Draw, Bla^qg Paddles. MousePainl, 
and so orL 




After reviewing the instructions, press Return. The screen should then look 
like this: 



4t 



CHOICE #1 CURRENT SHAPE CHOICE #2 

In the middle of the screen is a tree. As you move the mouse around, the 
tree will also move on the screen. To draw the tree, just press the mouse 
button once. A permanent tree should now appear in the drawing, in 
addition to the one that follows the mouse pointer. 

Click to draw a couple of trees anywhere on the screen. 

Now press Control-Open-Apple-Escape to go to the Desk Accessory Menu, 
choose Softs witch and press Retum. 

Since we want to keep the DeskTop in Workspace #1 available for when we 
finish with this program, you should store Draw It in Workspace #2. 

Press the "2" key now to store Draw It. 

Immediately, you'll see a copy of the active Mini-Screen placed in the 
Workspace #2 display screen. SoftSwitch now has both the DeskTop and 
Draw It stored. 



Return to Draw It now by pfessdi^ ibe Return key to go to the Desk 

Acomo^yMsmL Thm press Retiimcxiceiivm to 

progtaiiL 



Move (he mouse to tte bottom of the screen in order to select a new shape. 
Ibe OKHise cursor wiUchai^ to a cross-hair. By placing this cursor on 
ei1lierTlioioe#rorXhok%#2»"youcms^eaai^ Himarea 
total of 14 different shapes available. Select the house ^bapc (Choice #2 cm 
ibe li^) and place it somewhoe in your forest 

Now» click on Choice #1 (or #2, it works either direction) until the single 
dot (like a period) shape is the Current Shape. (You can also use the left 
and right arrow keys). This shape is used for drawing. Try it now by 
holdii^ down the mouse button as you mo ve 



As you draw, it will leave a multi-colored hne of dots on the 
£aster you move, the more widely spaced the dots will be. 



Now that you've scribUed all over the screen, maybe you*ke thinking you'd 
like to start over* In most programs/you*d erase die screen, and ^art 
completely over. Let's see how to use SoftSwitch to "rev^" bock to wheife 
tfae pogiam was when you only had a few trees on die screen* 

Go to SofiS wiidi as yoaVe done befine. 

llus tiine» die St^wildi display screen sboiM 





What Softswitch is showing you is that Workspace #2 contains Draw It as 
it was saved at 4:40 PM In the Active Works^ce is the program with die 
house and the soibbles at 4:45 PM. 

You warn to replace the Active ptDgrana with the piogpu^ 
Wcnkspace #2. 

ftc^ flic 'T' key DOW, 

SoftSwitdi will prompt you with "if you switch now, you will lose the 
oinent application. I^essT to|TOoecd", 

It is lonindingyou that if ^l«vert to die program the way it was 5 
minutes ago. you'll lose what you've got ri^ now. Since that is what you 
want, press "T* to confirm. 

The Active Wc^rkspace Mini -Screen will then cfaaqge to match Workspace 
#2. The reversion is now complete/ 

Press Return to exit SoftSwitch, and Return once more to be back in your 
piogiam - as It was 5 mnniles ago ! 




The moral of the story is: Don't press ControKi-RESET; use SoftSwitch! 
IVy to (dtai^ that habit of restarting die eittirc RESET to just 

switching to die DeskTopI 



By the way, just because you save a pro-am image, it doesn't mean you 
have to revert. It*s just another option thM &ftSwitch gives you. 

Now well see how to di^K^ of a stt)ied program. 

Go biudc to MtSwittii ik>w, 

Tte SoftSwitdi display screen appears. 

Bcess Open-Apple-2 to ^asc Workspace #2. 

bnmediately the Mini-Screen turns to a blank, showing dm SoftSwiuii has 
di^sed of its copy of die program. 

Try pressing 2, then Open*Applc-2 a few times now to see bow to store a 
copy of your program^ aiHl Itei «ase it, with SoMwitt:h* While you're 
tr^ng this, also mtim how die Ntoiory Status Box mmibars change 
stowing die mmmy CSoftSwi^h Ntencry**) when a program is 
stored, aM how it is i^easol wten die program is erased 

You cm idso press 3 and Open-Appk-S to use Workspace #3. SoftSwitch 
really (toemtouB in which order work^ces are stored. 



More about the Apple H PeskTi^i: 

yott iJtKmkl like ihe Selecit^ n»»i ID be au^^ 
first ^rttqi SS Jl^HMIMSK, rename die kxm '^SdecttH^JC*' in the 
'*D^ii^'*fi^tott>"Sdectcr«** Ic»iscanberaQ£U0edusti^ihe**Renamean 
fccm" chok^ in die "Sp^id** mmi of die DedcT<^. 




Example #3: Storing Multiple Copies 

Suppose when you revert to a previous state, you also want to keep a copy 
of where you*re at now, just in case you change your nmd again? You can 
with Softswitch. 

Since you've just reverlied to the original picture with only trees, go back 
mi draw a house, some lines, or wh^ver el^ you want to add to the 
picture. When youVe added a fair amount to the picture, go to SoftS witch. 

Thk is very much like the way it was the first time you reverted. This time, 
however, we'll assume you want to keep this program state aroimd in case 
you change your mind agaia Simple, 

Rress tte 3 key to store a copy of this program in Workspace #3. 
You*U see the Mini-Screen appear in Workspace #3, 




Now press the 2 key. 

Youll see the Active Woikspace di^lay change to the earlio* versioa 
There is no warning prompt this time b^use SoftSwitch knows there^s a 
cx>py in Woikspace #3, so no data can be lost. 



If you go back to your program, make changes, and then re-ent^ 
Softswitch, youll now have three different program states on hand. You 
can either save the third and revert to either of the other two, or you can 
switch to the one you want, and erase the others. 

When youVe done using a given program, you*ll probably want to go to 
Softswitch and erase its Workspace. This will release the stored memory, 
before quitting the program itself as you normally would. It doesn't hurt 
anything to have a stored program in memory, but there's also no reason to 
leave something around you don't n^. 

Even though Draw It has a Quit command, you've already learned a faster 
way to quit and run another program by using SoftSwitch and the stored 
DeskTop. 

Therefore, to quit Dmw It, just follow this sequence: 
Go to SoftSwitch. 

Switch the DeskTop in Workspace #1 to make it the Active Workspace. 
Erase the copies of Draw It in Workspaces #2 and #3. 




Press Return twice to kave SoftSwitch and go back to the DeskTop. 




Example #4: Switching with Auto-Save 

You can also use SoftSwitch for fast access to a program use a lot, by 
switching between it and whatever other program is stored at the moment. 

The DeskTop makes an excellent "accessory" to many programs because it 
can be used to format a disk, aypy or delete fdes, and it has its own built-in 
"desk accessories,'* such as the calculator. With SoftSwitch, you can go to 
the DeskTop while you*re in any program, and use its features as an add-on 
to any otha program you wish. 

To tow this migte work, run Draw It again from the Selector menu in 
the DeskTop. I>raw a few trees and so on, then go to SoftSwitch. Save it 
in Workspace #2, th^ go b^k to Draw It and draw a hou^ or two* 

Now suppose you're in Draw It and suddenly want to calculate some 
numbers, such as the number of board feet of pine need^ to build a casde. 

Go to SoftSwitch now. 

You could switch back to flie DeskTop by pressing "1", Init you would get 
tte "If you switch now you will lose the application in memory" message* 
It*s telliig you fliat SoftSwitch has E^w it as it was when you first stored 
it, not the current program state. 

To switch without losing what you have now, you'd have to erase 
Workspace #2 (Open*Apple-2), and then store the new program state before 
switching to the DeskTop (Workspace #1). 

You're probably wondering, isn't there any way th^ SoftSwitch could 
automatically update the stored woiksp^e so you can switch without any 
prompting? The answer is yes: just turn on the "Auto-Save" feature* 

Press Open-Apple-S now to activ^e Auto-Save. 

SoftSwitch will prompt you with "This will overwrite the selected 
workspace with the application just interrupted. Do you want to piDceed? 
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Auto-Save works by syndironizing the appropriate stored workspace with 
the currently active one. By turning on Auto-Save now, SoftS witch will 
update Workspace #2 wilh the image of the cuirently active program. This 
is what you want to do, so piiess "Y", 

Now you can switch freely between piogran^ #1 md #2. Try it mm by 
pressing 1, then leaving SoftS witch to go to the D^Top, 

h the D^Top, pull down the **apple" menu in the upper left-hand comer, 
and select the Calculator. Click on the buttons with ihe mouse to see how it 
woiks, 

Tten go back to SoftSwitch, press 2 and Return twice to switch back to 
Draw It Do this a few times until you understand how to switch between 
the two programs using the Auto-Save feature. Auto-Save automatically 
updates the stored Workspace each time you enter SoftSwitck Auto-Save 
can be tumed back off by pressing Open-Apple-S again. 

If you wanted to switch between two prop-ams, plus k^p the D^kTop on 
hmd, you would first store the DedcTop in Workspace #1, then exit 
SoftSwitch and start the first application program. Save this in Wo±space 
#2, Ttei switch tek to the I^skTop arwi start the second program, store it 
in Workspace #3 and turn on Auto-Save. Then exit SoftSwitch to either of 
tte applicatiiOTs to bepn your work. 

This is the most common way to use SoflSwitck The general procedure for 
setting things up is: 

1) Start up with the DeskTop and store it in Workspace #1, 

2) Return to DeskTop and start up progi^ #2. 

3) Store it in Workspace #2. 

4) Switch b^k to ite DeskTop and start arM)ther propam, if desired. 

5) Store it in Woifc^ace #3, and then tum on Auto-Save, No prompt will 
be prii^ since tte sto^ workspace at that point is identical to the 
active workspace. 

6) Switch fiieely betwem programs using just the number keys, 

7) When done, go to SoftSwitch and tum off Auto-Save. 

8) Press the number key (usually 1) for the DeskTop, then erase the stored 
workspace for program #2, and exit SoftSwitch hack to the DeskTop. 



Example #5: Switching 3 Programs with Auto-Save 



If you warn to switch betw^a three programs, the procaine is basically the 
smm, except that you will have to erase the DeskTop in Workspace #1 to 
make room for tf^ third program. Start with the DeskTop sayrcd in 
Workspace #1, Use tlie D^Top to smt tte next program, then store it in 
Wortepace Switch back to the DeskTop aiwi start the next program, 
then store it in Workspace #3. Switch back to the DeskTop and start the 
final program. Then go to SoftSwitch, er^ the DeskTop fircnn Workspace 
#1, and save the third program them. Finally, turn on Auto^ave and 
switch freely between them. 

Remember that Auto-Save slK)uld not be tun^ on until the last program is 
stored in a Workspa^. 

When youVe finished using the stored programs, remember to go to 
SoftSwitch aiKl turn off Auto-Save. Then quit one of the programs (for 
exanq^le, the program in Workspace #1) and let that program return to the 
D^kTop from the disk. Then go to SoftSwitch, erase that program*s 
Work^Kice wad save the De^Top. Then erase any others you dorft need 
any more, and exit SoftSwitch bik to the DeskTop, 

If you have 5 12K or hss m your RAM Expansion Card, the only way to 
stoie three programs in SoftSwitch is to avoid using Applet Progmm 
Laimcher. Hie Launchor is a conq)letely different program selector than the 
DeskTop, and is included on the SYSTEM.DISK that came with your Apple 
IIGS. (All of this presumes that your RAM disk size is set to OK). 

If you have 768K or more of RAM on your RAM Exfrnsion Card (ai^ 
more than 512K is available to SoftSwitch), Hmn you can use the Program 
Launcher to set up all three progimns if you wish. 



Example #6: Switching DOS 3 J or Protected Programs 



Running a DOS 3.3 program, or a disk that is copy-protected, such as 
Dazzle Draw or Print Shop, requires a little different ^proach. Because 
these programs canrot be opened from the DeskTop, you worft be able to 
just click on ttie name there. You obviously abo can't turn off the power 
and turn it tack on again to stm the disk because this would erase 
SoftSwitt:h firom the D^k Accessory Menu. Pressing Contml-Open-Apple- 
RESET to restart wuld have the same effect 

In addition, DOS 3.3 and most protected programs have ik> provision for 
quitting ttan tack to tte DeskTop ote than to turn off the power and 
restart 

Fortunately, there is a way. The DeskTop has a menu called "Startup" that 
you can use to startup a disk without erasing SoftS witch, or even any of the 
stored programs currendy in Workspaces. 

You must give some thought to the ordor in which you want to save your 
switching Works|mces. For example, if you start up Dazzle Draw first (or 
any protected piogram), ai«l iten store that in SoftSwitch without first 
saving the DeskTop, you'd have no way to quit Dazzle Draw, and thus no 
way to get tack to the DeskTop to select anotho- program, or to u^ Startup 
again for another non-ProDOS disk. 

The ^iest solution is to be sure to fiist save DeskTq) in Workspace #L 
Then use Startup to start the DOS 3.3 or protected PtoDOS didc you want 
When that jro^am is saved in Woricspace #2, switch tack to DeskTop to 
run or start up the next program for Workspace #3* 

By leaving DeskTop ^ored as Workspace #1, you*ve always got a 'T>ack 
door" to any program. You can use SoftSwitch to exit the DOS 3,3 or 
protected programs and then go tack to the DeskTop by switching to 
Workspace #L TMs is also useful as a "clean" way to shut down those 
programs like Print Shop without taving to re-start when you*re done. Just 
make DeskTop the active workspace by pressing its number key, and then 
use the Open-Apple-# key to erase tte stored imag^ of the non-quittable 
propams. 




By the v/ay, if >t>ute comfortable with t^ing **¥M6*' from BASIC to start 
a disk, then you can also use that to start any non-FroDOS disk to be 
switched by SoftSwitch, You can get to BASIC by choosing 
BASIC.SYSTEM in the Selector menu of the I>eskTop, 

IMPORTANT: Some software programs, most notably almost all 
software from Broderbund, Inc., have "false" Quit options in their mmus 
that instead of a propo" quit back to the DeskTop, clear all of memory and 
do the software equival^t of a Control-Open-Apple-RESET. This erases 
SoftSwitch md my other stored programs in memory. 

For this reason, you should never use a Qiit option th^ do^ not return to 
die DeskTop, no matter how attr^tively it's offered. Instep, use 
SoftSwitch to switch back to the DeskTop, then erase the offending 
application from its Workspace, if desired. 

Programs such as MouseWrite and AppleWorks, which require a normal 
Quit, can be exited normally. 



1 



Chapter 4: Supplemental Programs 



TMs chapter discuss^ some of the further featuires of SoftSwitch, and also 
other progmms such as Keq)sake and the Saeen Managcx that are on the 
SS.SYSTEM,DISK, 



Example #7: Capturing a Screen Image 

Anodier special feature of SoftSwitch is its ability to capttii^ a screen image 
from one program, and then to "paste" this image into aiK)ther, 

Before looking at how this is done, a short explanation of the various scre^ 
displays on an Apple IIGS is in order. 

There are a total of 13 video screen displays available on the Apple IIGS. 
They are as follows: 

40 column tmu pa^ 1 and 2, 
80 coluiM tett page 1 and 2, 
Lo-R^ ^phics, imge 1 and 2. 
Etouble Lo-i^ ^phic^, pa^ 1 arui 2, 
Hi-Res graphics, page 1 and 2. 
Double Hi-Res gi^hics, page 1 and 2, 
Super Hi-Res graphics, page 1 only. 

Many of these displays use the ^me part of manory as atK>ther. That is, 
what you see just ch^ges depending on the dkplay mode of the computer, 
but you're still looking at the same part of memory. 

As an example, if you've seen the 80 column screen suddenly go to 40 
columns, you may have noticed that every other character from the 80 
column screen is left on the 40 coliunn screen. This is because the 80 
column display mode uses the same memory that the 40 column display 
uses, plus another equal amount of memory to double the number of 
columns displayed. 



SoftSwiteh can examine and copy tte following screen displays: 

40 column text, page 1 only, 
80 colimm text, page 1 only, 
Hi-Res graphics, page 1 and 2. 
Double Hi-Res, page 1 and 2, 

Having "captured" one of ttese images, SoftS witch can ttei paste it into 
aiK)ther propam on either a Hi-Rcs or Double Hi-Res display, depending 
on what was captured. 

Most of the time, you won*t need to know which display mode or page is 
being used to create what you see in a pven program, but urderstanding 
that ttoe are many different modes will make it easier to undeistand what's 
going on when you use SoftSwitch» 

In many graphics programst the "picture" that you create is stored in two 
places within tte progrant The entire picture is first stored somewhere in 
memory, often on "page 2". This pictuiti is not necessarily ever sem by the 
user of the program, histod, this image m merged with whatever menus, 
prompts, window bordm, and so on, that the program creates for the actual 
display that you see while using it. 

For example, lef s consider a program called Dazzle Draw, from 
Broderbund Software. As you look at the picture youVe working on, you 
can also see the mmus and other program features display^ at both the top 
and bottom of the screen, like this: 




Page 1 



Page 2 



One of those options is a choice to view the entire picture. 

Dazsle Dmw (and many programs Bke it) keeps the entire picture on the 
page 2 display. What you see while you work with the program is the page 
1 display with Mded menus and program screen displays. When you select 
"View Entire Picture," the conr^uW changes tte display for a moment to 
page 2, and the menus, etc. "disappear," 

Thus, if you wanted to capture the actual picture being worked on, you 
would want to copy the page 2 display, not the page 1 display diat incliKled 
all the unwanted "extras." 

Likewise, if you wanted to paste an image into Dazzle Draw, you would 
want to paste the image into page 2, This is because page 1 is constandy 
being re-dmwn tesed on tte image on page 2. If you pasted to page 1 , as 
soon as the screen was redrawn, the image would change back to the image 
from page 2. Instead, if you paste an image into page 2 in Dazzle Draw, 
this will become the master image for the picture and display screen, and 
you can then edit or save this picture as you would any other. 



Example #8: Examining the Image 

Hie best way to get a feel for this is with an actual example. Run die Draw 
It program from the D^kTop, and then draw a few trees in die middle of the 
screen. Then ctaige the current shape to die "house" shape. 

Go to Softswitch, and dien press 0[^n-Apple*E to "Examine" die image. 

This command lets you examine die different text and graphics display 
pages of die Acdve Workspace. The foOowing prompt appears in die 
Softswitch dialog box: "T = Text> 1/2 = Page 1/2 Graphics, S/D = 
Single/Double Hi-Res, C/M = Color Monochrome Video. C5C to Copy, 
C3V to Paste, Escape when done." 

This is a Mst of command keys that you can use while examining die 
different display pages for die image you want to capture. Note diat you can 
only copy and paste while you are actually in Sof tSwitch, mi within the 
program itself. 

Press "S" for Single Hi-Res now. 



The saeai display will change to show you Hi-Res page 1 , which in this 
case is the main working screen of Qraw It, (X)mplete with the shape choices 
at the bottom of tte screen. So wtere is tte picture that can be viewed with 
the "V** key in Draw It? 

Press "2" for page 2, 

The display will now change to Hi-Res page 2, If you press the "T" (for 
"Text") key» you can also see tte help screen iomge of Draw It 

You use tte Open«Apple-C command to capture or ''copy*' the screen image 
you're viewing. 

Press the *'S" and "2" keys now so that you can see just the picture itself, 
without the options at the bottom of the screen. 

Now press Op^-Apple-C. 

Softswitch will a)py the image onto its "clipboard/* and then immediately 
return the display to the normal SoftS witch display sc«en, 

"Pasting*' means placing the image that is stored on the SoftS witch clipboard 
into another program (that can accept it). Pasting is done by first switching 
tte target p-ogram into the "active workspace", and then using tte (5-E 
(exanune) command and (5-V to paste the image. You can paste into any 
progmm that stores and uses within itself a cx)mplete Hi-Res or Double Hi- 
Res picture. Tte examine command is used to make sure you're pasting 
onto the right image. The Screen Manager is a program that has been 
provided on the SS.S YSTEM.DISK to help illustmte this process. It is 
only a representative of a general class of programs, and is not required to 
use the Copy & Paste feature of SoftSwitcL 



Example #9: Using the Screen Manager 

To see how Screen Manager is used, switch to the DeskTop (assuming you 
are still in SoftSwitch). Thm choose "Screen Mgr." from die Selector 
menu. 

Screen Manager is a simple program on the SS.SYSTEM.DISK whose sole 
function is to load and save Hi-Res and Double Hi-Res pictures, and to let 
you view them once they're loaded into memory. 



When you nm Screen Manager, yoEll first see a dde screen, and then this 
menu: 



Select a Number Press RETURN '| 



Althougji you haven*t loaded a picture from disk yet, you can take a look at 
what is ciurendy in memory* 

Select menu item 2 now. 

Youll be stown Hi-Res page 1 . If ;^u press "D", tte display wUl switch 
to the Double Hi*Res dii^lay. You cm switch it back to Single Hi-Res by 
pi^e^ing "S" agaia 

Press Return to go back to tte Screen Manago: main menu. 

Now go to SoftSwitcJi, and press Opeai-Apple-E to examine the Scre^ 
Manager display pages. 

Rress "S" to see Hi-Res page 1 again, axri by pressing "D" you can see tte 
Double Hi-Res page. 

Now press tte "2*' key to view page 2. 

You can now examim graphics display page 2, in both Hi-R^ and Double 
Hi-Res, For the Screen htonaga** page 1 is where the program stares its 
graphics images. 

Rm^mber that a copy of the picture you captoed is still on ttie SoftSwitch 
clipboard* To paste it into the Soeen Manager* press the "S" and "1" ke;^ 
to look at Hi-Res page 1 again. 



Screen Hanaser 



ESCAPE^ Quit to BASIC 



nain Menu \ 

1. mam 




4. Quit to BASIC 



Now press Opcn-Apple-V ("V" is the Apple standard key for **p^te") to 
place the image in die Screen Manager's Hi-Res page 1 , Press Return (or 
Escape) to go back to the main SoftSwitch sareen* 

Now exit SoftSwitch and go back to the Screen Manager, From the main 
menu, things look pretty much the same, but select item 2 to view a picture 
agaia This time, you should see the picture that you captured from Draw 
It 

To save the picture to disk, just select item #3. The disk directory will 
appear. Type in TTIEES and press Return, The picture will be saved to the 
didc. 

Thfa is tte imthod you can use to capture the screm image from almost any 
propam, and tiMi paste it into the Screen Manager to be saved. In our 
example, you didn't actedly use SoftSwitch to keep a stored copy of the 
Screen fttonager on hand, but this could have been done as well, if you 
anticipated switching many times between several different programs. 

This copy & paste method can also be used to move a picture from one 
oper^ing system to another, for example, DC^ 33 to ProDOS. Simply 
load both DOS and ProDC^ picture hatKilii^ programs into memory (such 
as Blazing Paddles and Sc^^en Mana^r), aid ten copy a picture loaded 
with one and paste it into the oter. Tte copied image can be saved, edited, 
or printed, depending on the capabilities of tte reiving program, 

SoftSwitch can also captoe 40 aM 80 a>lumn text soeois with the copy 
command. Hie text screm is imn^aely a)nverted into a Double Hi-R^ 
picture by SoftSwitch and can be savoi and loaded later using tte Soeen 
Manager, The main use for this is for printing out screen imag^, or "screen 
dumps" using a graphics printing program to print the capture and saved 
image. 

SoftSwitch does not convert Hi-Res imag^ to Double Hi-Res m vim versa, 
and so will not let you paste the wrong image type into another program. 
The Screen Manager program can accept eiter Siagle or Double Hi-Res 
images, but some programs, like Dazzle Draw, may accept Single or Double 
Hi-Res only. 

See Appendix C at te back of this manual for tips on how to copy & paste 
images with specific commercial programs. 



Example #10: Loading and Pasting Images 



The reverse process of the previous example would be to load a picture into 
memory using the Screen Manage, and to then paste it into another 
program, such as a drawing program like Dimw It 

If you dorft already have the Saem Ntaiager in n^mory, run it now from 
the DeskTop. 

Select menu item #1, "Select Picture from Disk," 

Tte Select Fictme function will first give you a list of ail disk drives 
currmtiy connected to your Apple IIGS. 

Select SS.SYSTEM.DISK. 

On the SS.SYSTEM.DISK should be your saved picture "TREES", from 
tte previous example. Select this picture to load. 

When it's loaded and you are returned to tte main n^u, use item 2 to view 
ttepictufe. 

When you are done viewing tte picture, press Return to go back to tte main 
menu. 

Now go to Softswitch and press Open-Apple-E to examine the display 
pages, ftess "S" and "1" ^ see the picture you just loatoi. 

Now press Open-Apple-C to copy tte image to tte clipboard. 

Switch to tte D^kTop and exit SoftSwitch. Run Draw It from tte Selector 
n^nu (or switch lo it if you have it stored in a Workspace). 

You want to paste tte image just capture from tte Screen Manager program 
into Draw It You could do this now from SoftSwitch, but it might te hard 
deciding where to paste the image if no image exists there yet So, tefore 
pasting iniD a program, it is always a gCKxi idea to look at whateva picture 
th^ program already has in tt^mory. Then you'll know what you're about 
to replace. 



To create something different than the currently on the SoftSwitch 
clipboard, press Escape and **E" to erase any picture cuirenlly in Draw It 
Tb^n use the mouse to select tte house. Dmw a few houses on the scr^n, 

Tl^n go to SoftSwitch, and press Open-Apple-E to examii^ the display 
pag^ of Draw It On Hi-Res page 2 you should see your houses. 

Press Open-Apple-V to paste tte image. 

The image will be replaced with the TREES picture loaded by and copied 
from the Screen Mamget Now return to Draw It 

Wten the Draw It scieen appears, you may be surprised not lo see the 
pasted pictu)^. This is because although you pasted the image onto page 2, 
thus replacing the picture, the working screen hasn't been update yet 

To update tte screen, pms "V* to view the picture. 

The new picture appears, and when you press a key to go back to the Draw 
It screen, the new picture has been updated into the program. 

The actoil procedure for updating the screen may vary between pro^^ms, 
but the principle is the same: 

1) Rrom the fuist (source) program, capture the ^tual picture image, not a 
working screen, with the SoftSwiK:h Copy (dQ conunanA 

2) Run (or switch to) the second (destination) p-opam, and identify the 
actual picttu^ location (not ite working ^reen) there. Paste the image using 
tte SoftSwitch Paste ((5V) command* 

3) Fuially, retum to the destimtion program, md force it to update its 
working screen. In most programs this is done by just viewing the entire 
screen picture, and then going back to the working screen. 

Note: Whm saving pictures to disk. Screen Manager ordinarily saves 
pictures to tte disk from which it was run. If you want to save a picture to a 
different disk or subdirectory, u^ the "Select Picture finom Disk" option, but 
do not load a picture. Instead, just select *'Set This Prefix" when you have 
found tte desired disk or subdirectory. Tten, when the picture is saved by 
Scr^n Manager, the selected prefix will be used. 

Again, be sure to se^ Appendix C for lips cm specific a>mmercial progmms. 



Example #11: Storing ProDOS Programs with Keepsake 



The Keepsake progi^ is on the SS.S YSTEM.DISK diskette and is used to 
move a stored Workspace ftom the Apple IIGS to disk for long term 
storage. The principle is fairly simple* After a program has been stored in a 
Workspace with SoftSwitch, go to the DeskTop aiul use the Selector mmu 
to run Keepake. Lefs try it now with Draw It. 

If it's not already in memory, run Draw It, draw a few trees or whatever, 
and then store the program image in Workspace #2. Now switch to the 
DeskTop. 

Now run Keepsake by choosing it in the Selector menu. The following 
screen will appear: 




In the Workspace #2 Mini-Screen, you can see the image of the stored Draw 
It program. To load or save a Workspace to or from tte disk, you must first 
press the number key of the desired Workspace. 

Press tte 1, 2 or 3 keys now. 

The Active Workspace display will change as you press each key. 



To save Workspace #2, press the 2 key to first select Workspace #2, and 
then press '*S" to Store to EHsk, 

Ttm screen will now change: 




Currert Pre^Mx^ /SS.SySTEfl.DlSK/ 
Norkspate Prefix = 



Enter Mm to proceed* or ntu H\mm. 



The fii^t prompt is for the volume nan^ of the disk you want to save the 
Workspace on, and for any added names or subdirectories in tte pathname 
you want to use. For example, if you had a hard disk, with a subdirectory 
"WORKSPACES" on it, you could type in: 

/HARDl/WORKSPACES 

as tte complete patteiame. 

For now, though, let*s use the SS.SYSTEM.DISK. To use the default 
naiTO, just press Retura 

The next prompt will be for the name to save the Workspace under. Type: 
MY.DRAWING 

and press Return. The disk will then come on as the suspended program 
from ^^Draw It" is saved on the SS.SYSTEM.DISK. When ite save is 
complete, the Keepsake display screen will return to the display of all the 
Workspaces. 




Before seeing how to resume a stored Workspace, let*s go to SoftSwitch 
and erase any stored Workspaces. 

ftess Control-Open-Apple-Escape now to go to SoftSwitch. 

When you enter SoftSwitt^h, the Active Woricsp^ Mini-Screen will show 
the Keepsake screen. If yon tried to save K^psake at this point SoftSwitch 
would give yon an error message remindii^ you that it can't save ProDOS 
16 applications. 

Even though Keepsake is a BroDOS 16 application, and not tisable by 
SoftSwiteh as a switchable pro^im, you can still go to SoftSvritch from 
within it This can be used when you want to era^ any Workspace needed 
for loading Woricspaces from disk. 

You wmt to erase the stored version of Draw It , Prying Open-Apple*2. 
Then exit SoftSwitch and go back to Keepsake. 

You can tell Keepsake to update its screen displays by pressing the space 
bar. Workspace #2 is now en^ty. 

To quit Keepsake, press "Q" to Quit, and Select the 'Hetum to DeskTop'* 
optioa 

See the r^xt example called ''Rm)ring with Keq)sake** for doails on how 
to restore a program from ^k. 



Example §12: Restoring with Keepsake 



Now let's see how to restore a RroDOS stor^ Workspace from disk. 
Select Keepsake from the DeskTop "Selector" menu. When it is up and 
nmning, pr^s the "2" key, and "U' to tell the program you want load a 
program from disk. You can only load saved progranas into an empty 
Workspace, If Workspace 2 is not empty, go to SoftS witch and Open- 
AppIe-2 to era^ it. 

As before, you can enter the volume name along with any subdirecU)ries for 
the location of the sU)red Workspace. For now, press Return to accept the 
default of SS.SYSTEM.DISK. 

For the filename itself, you could enter the narm MY.DRAWING direcdy, 
but there may be times when you dorft remember the exact name you used. 
Let's see how to look at the disk. 

Witiiout entoing a txame, press Return alone, and then "C" (for "Catalog*') 
to see what files are on the disk. If there is more than one file on the disk, 
pressing "C* will continue the list. The first entry is "SYSTEM", a 
diiecU)ry file. Press "C" to skip ^s. When you see the name 
MY.DRAWING, press Return twice to load the file. You wOl see tte mini- 
image appear in Workspace #1 when the load is complete. 

Quit Keepsake by pressing "Q" and Return, and go teck to the DeskTop. 
Then go to SoftSwitch, SoftSwitch is now loaded with the DeskTop aiid 
MY.DRAWING. Switch to Workspace #2, ainl then exit SoftSwitch. 

You will find yourself exactly where you left when it was saved in 
SoftSwitch, and then storal on the didc. 

As another example, try loading the saved Workspace file called 
WS .HUNGRY using Keepsake and resuming it from SoftSwitch. 

You shotild find youmlf in a program saved quite some time ago, and 
stored on the SoftSwitch diskette. "The Hungry Dot" is a program that 
shows the adventures of a little dot on the screen as it bounces around eating 
everything in its path. 



If ym tove a nKmoctoome moniior, the dot may be difficult lo see. If so» 
pi^ the "M" (for "monochroim") key to get a larger dot ("C", for color, 
restores the dot lo the XKjrmal size). Pressing any other key will stop the 
program. If you would like to save it as an Applesoft program, siiicq>ly 
press a key to stop the {m^gtam, type TEXT for a Ml text screen disptay, 
and thra type SAVE HUNGRY.DOT mi press R^um to do fiie save, 

TT^ program can then be run directly from the DedcTop m Aj^lesoft as 
wish. 



Example #13: DOS 3 J and Protected Programs 

Using K^isakewidi DOS 33 c^ncKi-standardEto programs is ordy 
slij^Hy different dian the mmmi procedise. 

Restoring programs from disk is done in the usual way. only coricmi 
is wh^ior tlm program you restore is the only program in SoftSwitch (i.e., 
no D^Top in Wcwrfc^ace #1)* If you use SoftSwitch to switch to the 
stored program, arrf it's a protected {rogram Am you can't quit from, ^ull 
have m way of getting out of it aiKi back to the D^Top without timiing off 
the power m doing a Coiwrol-Opea-Apple-RESET startup. 

The answo^, of OHirse, is to just save the De^op in c»tie o 

Workspaces bdcH^}^ switch to the program ^'rere^^artii^. Thatway, 

when ^u're finidied, can switch back lo the DeskTop. 

likewise, wh^ you waitt to save a DOS 33 <r non-standard RroDOS 
pogram to disk using Keq^sake, ^u ^imild first save the D^Top, then 
run the d^bed prograia Iben you can switch back lo the DeskTq) to run 
i^psake. 



Example #12: Restoring with Keepsake 



Now lefs see how to r^tore a ProEKDS stored Workspace from disk. 
Select Keepsake from the DeskTop "Selector" menu. When it is up and 
running, press the "2" key, and "L" to tell the program you want load a 
pro-am from disk. You can only load saved programs into an empty 
Workspace. If Workspace 2 is mi enpty. go to SoftSwitch and use Open- 
Apple-2 to erase it. 

As before, you can enter the volume mxm along with any subdirectories for 
the location of the stt)r^ Workspace. For now, press Return to accept the 
default of SS.SYSTEM.DISK. 

For the filename itself, you could enter the nan^ MY.DRAWING directly, 
but there may be times when you dorft remember the exact name you used. 
Let's see how to look at the disk. 

Without entering a name, press Return alone, and then "C" (for **Catalog") 
to sdt what files are on the disk. If there is more than one file on the disk, 
pressing "C" will continue the list. The first entry is "SYSTEM", a 
directory file. Press "C" to skip this. Wten you see the name 
MY*DRAWING, press Return twice to load the file. You will see the mini- 
image appear in Workspace #1 when the load is complete. 

Quit K^psake by pressing "Q" and Roum, and back to the DeskTop. 
TTien go to SoftSwitch. SoftSwitch is now lo^ed with the DeskTop and 
MY.DRAWING. Switch to Workspace #2, and then exit SoftSwitch. 

You will find yourself exactly wh^re you left when it was saved in 
SoftSwitch, aiid then stored on the didc. 

As another example, try loading the saved Workspace file called 
WS.HUNGRY using Keepsake and resuming it from SoftSwitch. 

You should find yourself in a program saved quite some time ago, and 
stored on the Soffi witch diskette. *The Hungry Dot'* is a program that 
shows the adventures of a little dot on the screen as it bounces around eating 
everything in its path. 



If you have a momxjhrome monitor, tte dot may be difficult to see. If so, 
prtss the "M" (for **raonochrorm*0 key to get a larger dot CC\ for cotor, 
restores the dot to the r^rmal size). Pressing any other key stop the 
prograiru If you would like to save it as an Applesoft Ingram, simply 
pi^ a key to stop the program, type TEXT for a Ml text screen display, 
and tlien type SAVE HUNGRY.DOT press Return to do Ihe save. 

The program can then be run direoly from the I>edcTop or Applesoft as you 
wish. 



Example #13: DOS 3 J and Protected Programs 

Using Ksqpssk^ widi DOS 3.3 m non-standard RpoDOS propams is only 
slighdy diflfer^ thai the normal procedure. 

Restoring programs from disk is done in die usual way* The only concern 
is wl^ho" the pro-am yon restore is the only program in Sof^witdi (i.e., 
no D^Top in WcKks^ce #1). If you use SoftSwi^ to swiidi to die 
stored piopam^ and it's a promoted fmgma th^ you can*t quit from, youll 
have no way of getting out of it and back to the EteskTop without timiing off 
the power doing a Cofitrol<)peti-A{^-RE$Er ^a^ 

The misw^, of course, is to just save the DeskTop in one of the od^ 
Wmksp^:^ before ^switoh to the pogramymiterestai^ng. Tliai^y, 
^»4ien ym!tt Fm^b&d^ ym can swiidi back to the D^Top. 

likewise, whm you warn to save a DOS 33 c^non-s^UKlard PioDOS 
program to disk usiog IGeq>sake, ymi shmdd first save the De^Top, dien 
runtfiedesiiedprognBn. Ttei you cm switch back to llie DeskTop to nm 
Keepsake. 



More About Keepsake 



If you have a 512K or less RAM Expansion Card (RAM Disk set to OK or 
more) or a 1Mb card with only 512K or less for SoftS witch (RAM Disk set 
to 512K or more), there isrft enough room for three stored Workspace and 
Keepsake. With these settings, Keepsate should only be nin with 1 or 2 
stored Workspaces, not 3* If you have a 1Mb card, and your RAM Disk is 
set to 256K or less, Hmn you can run Keepsake with three stor^ 
Workspaces. 

If you run Keepsake and theie isn't enough room in menK>ry to load it. 
Keepsake will prim an error message and letum to the the DeskTop. If you 
have trouble running Keepsake, try erasing one of your stored Worksp^es, 
or changing the control panel settings to provide mom memory for 
Softswitch (smaller RAM disk size). 

The usability of available RAM on the Apple IIGS depends on more than 
just how much there is. It is also important that continuous blocks of 
memory are available for prognms to ImA and run proparly. If you have 
run Keepsake, or used the Program Launcher, AppleTalk, or any ProDOS 
16 jHOgram, it is possible that SoftSwiu:h will mi be able to save a program 
in the third Workspace, even diough the Memory Status box shows some 
niem(^ still available. 

If you have trouble saving a Workspace, you may have to redstart the 
SS.SYSTEM.DISK to **clean up" memmy. If this happens often, you may 
want to change Urn control panel settings to provide more immory for 
Softswitch (^nailer RAM disk size). 

Saved Workspace lake a lot of disk space (289 blocks). The 
SS.S YSTEM.DISK (toes not have enough space to save more than one 
Workspace on it Thus, you must use anotter disk. You can use the 
DeskTop to format 3.5 disks, or to s^ how much sp^ is on a given disk 
by seating tte GET INFO function in the Special menu of the EteskTop, 



Appendix A: Things to Remember 



Keqp the foUowk^ gmMines mmind wbai imi^ SoftS^tck 

1) Here's the general imcedure for usuoig SoftSwiich: 

the DeskTop first in Woik^ac^#L Tbainmiq$plicatioii#2 butdo 
not quit it Iii^d> go to SofiSwitch and store the application in Works^mce 
#2. Then switch b^k to WQrk^[i£M::e#l and use tte 
application #3, This tedmique is useM for switdiing software^ s^ 
arcade gmm and protected software thM do not albw an adt without a 
con^lete le-start (u^iaUy the equivalent of pessing Control-C^>eii-Apple 
Reset). 

2) SoftSwitdi is very hardy. Starting a disk, as such« (k)esn*t ui^ 
Softswitch. As tong as you don't pess Control-Ojpm-Apple-Reset, or re- 
start into BroEKDS 16, Sof^witdi will remain active^ along with any saved 
Wcwkspaces. Thus, you can use a FRM in BASIC to start DOS 33 or 
ITOtec^ RroDOS programs, and SoftSwitch will switch ixm DOS 33 
pn^rams risJii aloi% with Pi^DOS 8 programs . 

3) Keep track of ^ur disksl If yon have only one drive and you have one 
program that's usif% a given <&ketie (like Print Shop), and dni switch to 
luiotber program that expects its own didc in the drive (like MouseWrite), 
ilfs up to ^u to make sure tte ri^ disk is in the drive* SofUSwitch is not 
equipped with £SPaiKlcan*tr^dboulof tbecofipiierandpatintheri^ 
diskforyou. If you have more than one disk drive, or a hard disk, this 
shcmldn*t be a problem; just start each program fiom it's own drive. 

4) Speaking of di^, you also shouMn*t save the smm pnogom in two 
differmt Wcrkspaces if that program writes fite to the disk. If tte 
opens a fUe and starts writing, and then you switch lo the i^cond copy of 
the same program, it may try tt) write to a half-completed file that the first 
isn't finished with. A g^ieral rule of thumb: If tte program writes files to 
disk, don't store two copies of it in memory at once* 

5) If you switch disks while you're in one program, aiKi thm go back 

to tte DeskTop, it worft know youVe sws^prf disks. To update the disk 
icons (a good idea if youVe changed disks), you ^uld select "Cbsck 
Disks" in tte "Special" menu. 



6) Softswitch does not save and lestore the state of nmning printers, 
modems, airf other attached devices. SoftS witch does not save the I/O 
(Inpul/OuQ)ut) status of inteiface cardb. Thus, if one piogram sets a serial 
caid to 12W baud, arrf aiM)ther program sets it to 9600, SoftSwitch will not 
mstom the baud ra^ after switching. La general, it is not a good idea to 
switch prop"ams that are in the process of using any of these devices. 

One exception to this is the mouse port. SoftSwitch remembers, and 
correctly sets, the independent states of the mouse hardware, including 
intemipl status, position and clamping between multiple applications. 

7) Do not switch programs while a program is writing to a disk. TTiis is 
because disk allocation is not updated until the end of the ''write*' proems. 
If you interrupt or switch a piogram while it is writing to the disk, md then 
switch to a program that was using the same disk (or you didn't swap the 
disk when yon should), the second program might overwrite the data that 
was in the process of being written by the fmt Be caj^Mf 

8) When quitting, son^ programs nmd to put away things, save information 
to the disk, delete tempomry files, and so on, TTiis includes programs like 
AppleWorks 2.0, ^fouseWrite, Point-to-Point, and a few others. You 
should not quit ttese programs by taking the SoftSwitch short-cut back to 
tte I>eskTop, You should quit these programs as you normally would, and 
let them take youteck to the DeskTop. It's slower, but necessary to make 
sure everything gets put back where it is supposed to be. Genmlly 
qjeaking, programs Uke this are fairly rare, md so you can usually use the 
SoftSwitch short-cut quit. You can tell which programs fall in this category 
because their manuals will caution you not to press Control-Open-Apple- 
RESET, but to use a Quit command instead. 

9) SoftSwitch will work in any program where the Desk Acc^sory Manu is 
accessable. Unfortunately ProDOS 1.1.1 shuts off interrupts, and thus 
locks out the Control Panel and SoftSwitch. If your pio^am uses ProDOS, 
make sure it is not ProDOS l.Ll. Likewise, certain arcade games and 
other programs that turn off intermpts will not be usable with SoftSwitch. 

10) SoB^ prograim may appear to deny access to the Desk Accessory 
Menu. Befom giving up, ^ alternating between pressing Control-Open- 
Apple-&cape ard moving and/or clicking the mouse. Sometimes this 
method will activate the Desk Accessory Menu and give you access to 
SoftSwitch. 



Appendix B: Common Questions About SoftSwitcIi 



* Why is the screm in hhck & while, and not cx)lor?" 

Softswitch us^ the Double Hi-Res graphics mocte of the Apple IIGS for its 
dkplay screen. With color enabled* charactars prin^ on the Double Hi- 
Res screen am pretty much unreadable. In addition, if the compressed 
pictures or Mini*Scr^ns w^ in color, it would be in^ssible to re^in as 
much detail as in black & white. Super Hi-Res could have bem used, but 
this would take an additional 32K just for the display. At a certain point, a 
design decision had to be imAe in priorities. Our decision was to try lo keep 
the size of SoftS witch down so that it would still be possible to switeh thi^ 
conq)lete programs with only a 512K RAM Expansion Card in the IIGS. 



"Why doesn*t SoftSwitch switch ProDOS 16 programs like PaintWorks 
Plus or Music Studio?'* 

The underlying principle of any switching program is to use the availability 
of more tmmory than the "switched" programs were originally designol to 
use. Obviously, one cannot switch ttoee programs that each use 5 12K of 
RAM in a machim with only 5 12K RAM available. Even with a megabyte 
RAM Expansion Card, storing two 512K programs wouldn't leave any 
room for SoftS witoh. However, it is possible that as larger monory cards 
becotiB available, a version of SoftSwitch will be designed to handle those 
programs that require a roinimum of 512K* 



'Why can't a single keypress be used right within my piogram to swiu:h, 
instead of having to go to the Dedc Acc^sory Menu?" 

SoftSwitch isn*i actually active during your program's operation. It only 
comes to life when you access it vm the D^k Acce^ry Menu. Tliis means 
that SoftSwitch isn*t available during your program to be checking for 
anything. In addition, no matter which key or sequence we pidk:ed, some 
program son^where would use the same sequence, ard there would be a 
conflict. An exan^le of this is Print Shop, described in Appendix D. 




"Do I have to i^re all the programs to be switched first, before being able to 
switch between them?" 

Yes, but that's just logical. It doesn't take any longer to load a pmgram 
with Softswitch in the background than without it, so you're not losing 
anything. What you gain is the ability to switch betwmi th© prograns. As 
an aside, the Keepsake program on the SoftS witch disket^ can be used to 
pre-load inteirupted prop^ns, but it k ^tually d^ip^ for iesunq)tion of 
suspended programs* not as a quick-load utility. 



Appendix C: Tips on Copying and Pasting Graphics 



SofiSwitch can copy my screra image on any of the d^play piges, evm if 
il is nol visible, in any swildiable {TOgram. However, ibe di^lay you see 
ontfaesoeenmaycu'inaynotbette^u^tiial '*pic^ edited in a givm 

graphics program. 

To paste an inoage inio a pt>gcam, and to Itai be abk to acmally use that 
image within ifae destination program, requires two $tq)s* 

Fii^t you have to paste the image into the im>per display page, SoftSwitch 
makes this easy by tetting you view ibe difFemtt display pages in any 
program before you pas^. In addition, it won't let you acdi^itally copy 
and piste images te don't match. 

For emx^le, in lookuig at a screen, you can*t always tell by just its 
appearance whette if s tm, Single Hi-Res, or Doubte Hi-Res. You can 
use the Soeen Managi^ to losA the picture "Self Pc^trait" to see a good 
ammph of this. Althoug^i you have sufficim information M SofiSwitch, 
because you setect tte display by pressing the "S", "D" m *T" keys (for 
Single iU-Res, Double Hi-R^ or Tact scre^), you still might nor 
remember the type of image on Ite clipboard whoa you paste. Ttoefore 
Softswitch only lets you paste into a destinatim display mocte that matt:tes 
lli^ mode of the image stored on tte clipbc^. 

The other variable between programs is whfch particular display page (page 
1 or page 2), tte picture image is stored on, in comrast to the working 
soeen image that you see while you run tte |m>gram. 

SecoEid, you som^in^ have to do something to get tte propam to 
recognize and use tte new iirmge that has been pasted into it Insome 
programs, as soon as you retom to tten» youll see your new i^ted image. 
In otters, you may have to do the paste M a particukr command levd in the 
progr^ For example* in Da^^le Draw you must choc^ the "View 
Pfcture" option and ibm reteim to fl^ menu soieen to update the woridng 
screen image. 

The following rotes provide helpful information on individual commercid 
gr^hics programs that you might want to use with die SoftS witch Cbpy 
and Pasto functions^ and tips on the various ways to get a pif hie image into 



and out of thrni Resxiemto thai althoui^ any dispky screen 
OTio tfie SoftSwitch clipboard, what you may ^^nt is the actual entire 
pictuie« not what you see on the woifcing screen that contains additional 
menuSt Hm cursor, md so on. 

Some package contain several difFocm programs, or diffaent menu levels 
at which a copy or paste might ocxnu^. Each eitfry indicates tte mm 
appioimate program md/ot menu level at which a ropy and pas^ should be 
done. 



MousePaint 

Apple Computer, Inc» 

Display Mod^ Single Hi-Res only, 
Pfcture Image: Not available. 

Copy: Any visible sareea 

Paste: Not available: MouseRiint does mi maintain a 

con^lete picture imj^e anywhere in mmmy at any 
time to enable pasting. 



DOS: RroDOS cmly. 
Load Pictures: 

Save Pictures: Yes 

Print Pictures: No 



Speeid Feauires: Uses Mouse tt> edit pictures. 

Note: Aldiou^ MousePsuit is not prnMcd to copy & fmte with, it can 
li^ and save the same Single Hi-Res pictures used by the Sc^^ Manager. 
This means you couU copy & paste lo the Screm Manager, then use the 
load or save picture function to access a disk me dso shared 
MousePaint 



Blazitig Paddles 
BaiidvOle, Inc. 
(^ools screen") 

Display ^fodes: Sii^ Hi-Res only. 
Picture Image: Page 2. 

Cq)y: Page 2, 

Pasie: Page 2 with tools displayed. Then click on any tool 

toupdaie. 

DOS: DOSSJcmly, 

Load Kctures: Yes 

Save Pictures: Yes 

Print Hctures: Yes 



Special Features: 



Zoom mode; add shapes & text; cut & paste portions 
of pictures* 



Pfadt 

BandvOle, Inc. 

("Pictufe Editor": "Function Menu") 

Display Mod^: Sii^ Hi-Res only. 
Mcture Image: I^ge 2, 
Copy: Page 2. 

Paste: Page 2 while at "RiiK^iion Menu"; update is 

unmed^. 



DOS: 

Load Pictures: 
Save Rctures: 
Print Pictures: 



DOS 33 only* 

Yes 

Yes 

Yes 



Special Features: Includes shape table editor. 



Prince 

BaudvUle, Inc. 

("Pictures" menu) 



Display Modes: Single and Double Hi-Res. 

Picture Image: Page L 

Copy: Page 1. 

Paste: Page 1 while at "Pictures" menu. Then use "Find" 
command (in Edit Pictures) to update. 

DOS: DOS 3.3 only. 

Load Pictures: Yes 

Save Pictures: Yes 

Print Pictures: Yes 

Special Features: Print cropped portion of any graphics screen. 



8/16 Paint 
BaudvUle, Inc. 

("PAINT.STD.HIRES") 



Display Modes: 
Picture Image: 
Copy: 
Paste: 



DOS: 

Load Pictures: 
Save Pictures: 
Print Pictures: 



Single Hi-Res only. 
Page 2. 
Page 2. 

Draw a line or anything at the main level. Then paste 
to page 2; press Escape (to "Undo") to update. 

ProDOS only. 

Yes 

Yes 

Yes 



8/16 Faint 
Baudville, Inc* 
CPAINT.DBLHIRES") 



Display Modes: Double Hi-Res only. 
Kcture Image: Rage 2. 

Copy: Pa^ 2* 

Paste: Draw a li» or anything at the main level Then paste 

to page 2; pr^s l^cape (to "Undo") to update. 

DOS: ProDOS only. 

Load Pictures: Yes 
Save Picture: Yes 
Print Pictures: Yes 

Special Features: DesipiedspecificaEy for the Apple IIGS. Very 
advanced picture drawing, editing and printing 
featares. 

Alpha Plot 
Beagle Bros. Inc. 

Display McKles: Single Hi-Res only. 

Picture Image: Both Page 1 and 2 (dual editing). 

Copy: Any saeen» cx>mplete pictures on both. 

Paste: Page 1 or 2; update is immediate. 

DOS: DOS 3.3 only. 

Load Picture: Yes 

Save Pictures: Yes 

Print Pictures: No 



Sp^ml Features: 



Edit both Hi-Res screens (pg 1 & 2), 



Beagle Serins 
Beagle Bros*, Inc. 
("Add Text to Screen") 



Display Modes: Single and Double Hi-Res. 

Picture Image: Page L 

Copy: Page 1. 

Paste: Page 1; update is immedia^. 

DOS: ProDOS only. 

Load Kctures: Yes 
SaveHctures: Yes 
Print Pictures: No 

Special Features: Pre-drawn sorons diat you can customize* Includes 
"slide show" program. 

Triple Dump 
Beagle Bros*, Inc. 
("Main Menu") 

Display Mocte: Single and Double Hi-Res, 

Picture Image: Pagel. 

Copy: I^ge L 

Paste: ^ge 1; update is immediate. 

DOS: ProDOS only. 

Load Hctuies: Yes 

Save Picti^^: Yes 

Priirt Pictures: Yes 

Special Features: Supports both Single & Double Hi-Res. 




Animate 

Broderbund^ Inc. 



Display Modes: 
Picture Image: 
Copy: 
Paste: 



DOS: 

Load Pictures: 
Save Pictures: 
Print Pictures: 

Special Features: 



Double Hi"Res only. 
Page 2 (background). 

Page 1 or 2 as desired (page 2 = background). 

NOT AVAILABLE: Pasting to Animate will crash the 

program (Animate)! 

ProDOS only. 

Yes (Single & Double Hi-R^) 
Yes (Single & Double Hi-Res) 
No 

Specialty prcKluct for animated Double Hi-Res 
gr^Mcs. Can convert pictures between Single & 
Double Hi-Res. 



Dazzle Draw 
Broderbund) Inc. 
("View Picture") 

Display Modes: Double Hi-Res only. 

Picture Image: Page 2. 

Copy: I^ge 2. 

Paste: Page 2; update occurs on return to menus. 

DOS: ProDOS only. 

Load Pictures: Yes 

Save Picture: Y^ 

ftint Pictures: Yes 



Special Features: 



Double Hi-Res screen editor. 



Fantavision 
Broderbund, Inc. 

Display Modes: Single Hi-Res only, 
Kcture Image: Page 2 (teckground). 

Copy: Page 1 or 2 ^ desired (page 2 = backgromd). 

Paste: NOT AVAILABLE: Pasting m Fantavision wiU crash 

program (Fantavision) ! 

DOS: ProDOS only. 

Load Pictures: Yes ("tekgrounds") 

Save Pictures: Yes ("backgrounds" only) 

Print Pictures: No 



Special Features: Nifty animation system. 



Print Shop 
Broderbund, Inc. 

("Screen iVfagic": "Draw Text on Screen") 

Dkphy Modes: Single Hi-Res only. 

Picture Image: Page 2. 

Copy: Pap 2 (*). 

Paste: Page 2 (*). 

DOS: ftoDOS only. 

Load Picture: Yes 

Save Pictures: Yes 

Print Pictures: Yes 



Special Features: 



Prints signs, greeting cards, etc. 



(*) Print Shop requires a special technique to access SoftSwitch. Bemuse 
it fireais the Oj^n-Apple key tte same way as Return, nan^ly sending you to 
a mxi menu level, it takes a little strategy to intcmipt Print Shop at the exact 
spot you want. 



You can take advantage of the feet that if you hold down the C^>en-Apple 
key, the program only advances am level, that is, k doesn^t continue to 
select itam Imm new n^us* 

The best way to pas^ a full-soeen inomge into the Soeen Magic portion of 
Print Shop is to select the choice "Draw Text on Screm" by pressing and 
holding down tte Open-AH>le key. The scr^ will chai^ to a new rmm. 
It is at this point, while continuii^ to told down the Open-Apple key, that 
you stould press Control-Escape* This will activme tte Desk Acc^^ry 
menu, firom wiiich you can go to SoftSwitch and paste the desired Single Hi- 
Ri^ image onto imge 2 in Wm Shop. 



Print Shop Companion 
Broderbund^ Inc 

("Graphic Editar-*"": "Get Kcture firom Meme^") 

Display Modes: Single Hi-Res only. 

Picture Image: P^ge 1 . 

Copy; Page 1. 

Paste: Page 1, Hi-Res or Double Hi-Res (*). 



DOS: 

Load Picture: 
Save Pictures: 
Print Hctures: 



DOS 3 J only. 

No 
No 



Special Fe^ures: Captoe portions of any Single m Double Hi-Res 
screen aS^convert it to a Print Shop graphic. 

Note: Alttou^ the Print SlKjp Conq^anion (PSQ is primarily a Sin^e Hi- 
Res product, it does have a fe^iie for capturing part of a Double Hi-Res 
screen, and converting it to a Print Shop graphic. 

The PSC can be used with SoftSwitch to omvert any graphic or text you 
canseeonthescreen,inanyprogram.intoaPrintShopgraphic, This 
means that if you want to convert tte dragon on your favorite miventure title 
screoi into a border gr^hic, you can. 



Tte main disadvantage of the PSC is that it is one of those programs th^ 
does not keep its permanent image of a Hi-Res screen in a standard place in 
menK)ry. It is possible to paste a Single Hi-Res pictiire into PSC» but only 
while viewing the complete Hi-Res screen image. This is done by first 
selecting "CoiUrol-G = Get" in the Graphic Editors- menu. The next menu 
will offi^ the choice "Get Picture in Memory." Select this. You will tfien be 
presmted with a Hi-Res soeen of whatever was in manory when you 
starts up the PSC disk. 

To pas^ m image firom the SoftSwitch clipboard, first go to SoftS witch, 
whUe Urn PK screm with tte cropping hoK on it is displayed. Here's the 
critical part: when SoftSwitch simws tte Mini-Screen for PSC, if you can 
see tte aopping box displayed, teck out (pr^s Escape) of SoftSwitch, go 
badk to ftm PSC screen, aiwl then go back to SoftSwitch again. The trick is 
to go lo SoftSwitch aid not have tte cropping box i^w up in the Mini- 
Screea If you paste an image while the box sho\^, youll get a box drawn 
on the screen image that you p^te into KC. It may take a few tries, but 
youll get it sooner or later. 

When you do, save the PSC program image in a Sofi^witch Workspace. 
Then switch to the program that you want to copy the graphk out of (if you 
haven't already copied a screen, that is). Copy die Hi-R^ image of your 
choice. 

Then switch back to PSC and paste die image onto page 1. Aftar the paste, 
press Return in SoftSwitch to go back to PSC. Youll see your pa$^ 
screen image with the cropping box. Pressing Return in PSC then captures 
whatever the cropping box has fiamed. See your PSC manual for specific 
PSC commands bom this point oa 

This is a good example of where "reverting" can come in handy. Once 
youVe saved PSC in just the right state to receive a picture (i.e, no cropping 
box stowing), you can convert a large number of graphic images by 
copying them from wherever you want, and then reverting PSC to the saved 
WcH-fcspace each tkm before doing the paste (as opposed to turning on Auto- 
Save $M having to try to get thinp "just right" each time). 



Doid)le Hi-Ri^ p^hics reqmies a different tedmique. The only way PSC 
can CBptoe a Doubte Hi-Res is lo have tte picture in memcny when FSC is 
start-up, ThcprocediirehereistofimusetheSaeeaMamgari^ 
on the SS JYSTEMDISK, and paste your Double Hi-ites image rxm the 

Thm exit the Saeea IM^n^er by pit^sing the Escape key, or setaing menu 
cboice#4. Wten you get the Applesoft pfcm5)t, type PR#6 and pr^s 
RmnitostMuprhePiteSk>pCoriq)amondi^ Itai go 10 the Graphic 
EditCM^+ part of the program, aiKt select "Get Pkture from Matnory." This 
technque wofks for Single Hi-Res pictures too. 



Hie Complete Graphics System 
Polart^irei Inc. 

("Picture Idittff" - main command level) 



Display Nfodtes: 
Pfcture Image: 
Copy: 
Paste: 



Page 1 mul 2. 
Page 1 ami 2. 
Page 1 and 2« 



Singte and Double Hi-Res. 



DOS: 



DOS 3 J only. 



Pictures: 
Save Pictures: 
PrimHctures: 



Yes 
Yes 
No 



Special Features: 



Primsufily designed tm creating aninmtion and full- 
screen pictures firomd^ files ratho* than krge 
bitm^ screois. 





EH^lay Modes: 
Picture Image: 
Copy: 
Paste: 

DOS: 

Load Pictiiies: 
Save KctiTOs: 
Priml^tiires: 

Special Fes^m^ 



Graphics Ma^dan 
Polarware, Iiic* 

Single Hi«R^ only. 
Mot specifically available. 
Any scieen as desired. 
Not av^able, 

DOS 3.3 only. 

Yes 
Yes 
No 

Brimarily designed ks: oeating animation and Mi- 
soeeapkttes finmi data fdes ratfier than large 
Umu^ screens. 



Draw It! 

E<^er Wagner ^blishir^^ Inc 
(OnSS.SYSTEM.DISK) 

Display Modes: Single ffi-R^. 
Picture Image: Page 2, 

Copy: Page 2. 

Paste: Page 2; pste while viewing picture ("V"); update is 

inmiediate. 



DOS: 

L^Kctures: 
Save Kctures: 
Print PicMes: 



P^DCWonly. 
No 

No 

No 



Special Features: Anybody can draw a picture with it! 



Screen Manager 

R<^er Wagner Publishing, Inc 

(On SS.SYSTEM.DISK) 

Display ^fodes: Sin^e Ek)uble Hi-Res, 

Picture Image: Page L 

Copy: Page L 

Paste: Page 1; update is iiiimediMe. 

DCB: PfoDCS only. 

Load Kc^ires: Yes 

Save Mctuies: Yes 

Print Pictures: No 



Special Features: 



Excellent "receiving'' program for pasted scimi 
images that you want to save to di^^ or a way to load 
pictures that you want to copy into other programs. 



Printographer 

Roger Wagner FubUshii^ Inc. 
(At "Main Menu") 

Display Modes: Single Hi-Res only. 

Picture Image: Ps^gc 2, 

Copy: Page 1 or 2. 

Paste: Page 1 or 2; selea **Edit Picture in Memoiy" to 
update. 

DOS: DOS 3.3 only. 

L(^d Hctures: Yes 

Save Pictures: Y^ 

Print Pictures: Yes 



Special Featuies: 



Prints in black & white (or color on appropriate 
priittm) on almost 100 different printers. If you've 
got an odd prints, this is the program to use! Also 
idds text, and can crop screens for partial print-outs. 



Graphics l^ander 
Springboard) Inc. 

SoftSwilch cannot be used with this prngm^ (Dedc Ao^sory Motu is 
disabled)* 



Newsroom 
Sproigboard, Inc 

SoftSwiu:h cannot be used with this propam* (De^ Accessory Mma is 
disable. 



Apple Graphics Software Companies 



Activision, Inc. 
P.O. Box 6286 
Mountain View, CA 94039 
(415) 960-0410 

Apple Computer, Inc. 
20525 Maiiani Avenue 
Cupertino, CA 95014 
(408) 996-1010 

BaudvUIe, Inc. 

1001 Medical Park Drive SE 

Grand Rapids, MI 49506 

(616)957-3036 

Beagle Brothers Software 
3990 Old Town Avenue 
San Diego, CA 92110 
(619) 296-6400 

Brodeibund, Inc. 

17 Paul Drive 

San Rafael, CA 94903 

(415)457-1170 

Electronic Alts, Inc. 
1820 Gateway Drive 
San Mateo, CA 94404 
(415) 571-7171 



Polarwaie, Inc. 
521 Hamilton Street 
Geneva, IL 60134 
(312)232-1984 

Roger Wagner Publishing, Inc. 
1050 Pioneer Way, Suite "P" 
El Cajon, CA 92020 
(619) 442-0522 

Springboard Software, Inc. 
7808 Creekridge Circle 
Minneapolis, MN SS435 
(612) 944-3912 



Appendix D: Commercial Programs and SoftSwitch 

Tliis section covm special techniques needed for using cmain commeicial 
pfOgrams with SoftSwitch. 



FroDOS 8, DOS 3 J, etc. 

AppleWorks 2.0 
Apple Computer, Inc. 

Note: The following infonnation does not apply to earli^ versions of 
AppleWorks. 

Because of Hm way that AppleWorks 2.0 uses Hm RAM Expansion Card on 
the Apple IIGS» it should wver be "revated" with Sofi^witck In otito 
words, you stmvld never install AppleWorks 2.0 as a SoftSwitch 
Worksp^, return to AppleWorks, shut it down, and then try to resume it 
torn memory lato^on by enuring firom another program, and then re- 
activating SoftSwitA*s saved Woiksj^ce* 

Unwise, once AppleWoiks 2*0 is install^, you should tura on Auto-Save 
imn^diately aflte installing it in a Wcwksp^, If Auto-Save has not been 
turned on, reverting will overrate pointers in die ^tive vo^ion, and thus 
cause ui^redictable results. 

AppleWorics 2.0 also has a tendency to commandeer all available mm^ry 
wl^ it first stmts. Tterefore, you should store it last» otherwise it will mi 
leave any n^mory for any of flie odier applications you want to switch. It is 
perfectly safe to store AppleWorks 2.0 last, turn on Auto-Save* and then go 
on your way. 



Apple OGS System Utilities 
Apple Computeri Inc. 

Treat dus set of programs like AppleWorks 2.0. Never revert it 



Flight Simiilator 
SubLogic 

FUglit Simoktor is not compatible with SoftSwitck Tliis is because the 
program does not proparly letum after going to the Desk Accessory menu, 
regardless of whether or ml SoftS witch is present. 



AirHeart 
Broderbund Soft^re, Inc. 

This program disabte the Desk Ao^^sory menu, mi so cannot be used 
with SoflSwitck 



Print Shop 
Broderbund Software, Inc. 

Print Shop pr^imes that any tin^ the Opm-Apple key is preyed, the user 
wants to advance to the next leveL Thus, the Conlrol-Open-Apple-Escape 
needed to access the Etek AccesscHy Menu (and ultimately SoftSwiich), 
always advaiK^ the program state one mmu further than you really warn. 
If a givOT program state is important, the only solution is to teck up one 
level using the Esc^ key (Escape is a Print Stop command), then press 
the Opoi-Apple key and hold it down. Continue to hold the Opai-Apple 
key until you're at the poM you originally wanted to inleirupt, then press 
Control^Escape' while continuing to hold down the Open-Apple key to go 
to Softswitch. 

♦ * # ♦ ♦ 

IMPORTANT: Some softwam programs, most notably ataK>st all 
software &om Broderbund, Inc., have "Quit" options in their mmus that, 
instead of a normal ProDO^S "Quit", itey clear a// nmmty when elected, 
and do the univalent of a Control-Opai-Apple-Reset before re-starting. 
This erases ^ftSwitch and any other stored programs in the machine. 

For thk ^ason, you stould never use the Quit option in these pmgrams, no 
matter how attractively it's offered. InsteM, switch back to the DeskTop and 
erase them from the Workspce they were stored in, if desired. 



ProDOS 16 Programs 



Althoug^i Softswitch cannot switch or stom ProDOS 16 pro^mns, it can be 
used to captoc and paste soeen images. SoftSwitch is not disturbed by the 
running of any PtdEJoS 16 program that follows good programming 
pmctices, i.e, doesn*t deliberately ten off access to the Desk Accessory 
Menu, allows for a normal PtoDOS quit, etc. This means ttat for a 
properly designed ProIX)S program you can start it from the DeskTop, 
copy or paste an image with SoftSwitch, and then r^um to the EtedcTop 
with a quit command widi SoftSwitch and any previously stoi^ programs 
still intact 

Unfortunately, most ProDOS 16 software currmtly being written for the GS 
violates one principle or another. 

A notable exception to this is Baudville's 816 Paint program, and we 
em:ourage you to let them know you apprecime it by supporting their 
company. 

Here's a brief list of ProDOS 16 programs. 

Music Studio, Activision: Doesn't startop from DeskTop properly. 

PatatWorks Plus, Activision: Woiks fine. 

Shanghai, Activision: Doesn't startup from DeskTop properly, 

Tass Times in Tone Town, Activision: Star^ ok from DeskTop, but 
turns off access to the Desk Accesses Menu, and dTOsn't restore it when 
you quit back to the DeskTop. 

816/Palnt Baudville: Works fine. 

Music Construction Set, Electmnic Arts: Starts ok from DedcTop, but 
no access to Desk Accessory Menu, and doe^'t have a quit command. 

Keei^ke, Roga- Wagner Publishing: A good example of a program that 
can be started from the DeskTop, allows copying of screen images, and 
quits back to the DeskTop with no problems. For fim, try copying the 
Keep^e display screen to the Scr^n Manager. 



SPEAK OUT! 

SoftSwiKA works with all propams that follow the Apple design guidelines 
for software. These guideline were put togetter by Apple to m^urage 
softis^re publisto^ to cre^ softwaie that was for everyone lo use. 

Software lhal do^'t foUow these guidelines makes life harda* for 
ev^one* Hare are things in particular that SoftSwitch doesn't like: 

1) No quit command, or quit re-boots instead of rdtumii^ to DeskTop. 

2) Erasing all of memory ^^Aim quittiiig. 

3) Disabling ttie Desk Accessory Mmi. 

4) Imx)nt^tibility with Desk Ac^cessories; i.e, access may be allowed, but 
propam oashes on return fiom Desk Acce^ry tmm. 

5) Hi-Res (or Double Hi-Res) images mi stored on normal gmphics 
screens, and^or CBCoded in mmiory. 

If you have programs that have Hmsc kinds of problems, wriie the 
pubttsfwr and tell them you want your software to w)rk for you, not 
againstyott! Of cour^ they wai^ your opinion -ttey gave you that nice 
registration ci^ and asked for it, rentiemba'! 

So, if youte using software, let other people know what you want; if 
youte wriiii^ software, take a litfle time to mate things e^r for everyone * 
thanks! 



Appendix E: Software Industry Use of SoftSwitch 



If you are personally involved in the writing or maiketing of software, or 
teach others about the Apple computer, xberc are certain features of 
SoftSwitch that you may find particularly useful. 



Software Documentation Illustrations CScreen Shots'^) 

When writing any instructions on the use of software, it is very helpful to 
the reader to have illustrations of the computer screen as it will appear while 
running a program. Traditionally, this involves either the expensive process 
of photographing an actual computer screra, or the printing of text 
characters in the documentation to simulate the screen appearance. Both 
methods are tedious, and even the photographic method rarely produces 
cleariy readable results. 

With SoftSwitch, however, you can use the display screen "copy" 
command to capture the program screen at any point, and without disturbing 
the overall operation of the program. With the exception of the Desk 
Accessory Menu screen in Chapter 2, every "screen shot" in this nnanual 
was captured from the running program using SoftSwitch, The SoftSwitch 
images were captured by pressing Control-RESET while the SoftSwitch 
screen was displayed, and then immediately re-entering SoftSwitch and 
capturing the Double Hi-Res page. 

Once the screen image is captured, it can be printed on any printer using any 
of the various printer dump utilities listed in Appendix C. Remember that 
both 40 and 80 column screens are converted to Double Hi-Res by 
SoftSwitch. 

If you are using a Macintosh and a LaserWriter to prepare your 
documentation (as was done for this manual), you can use a package called 
"ATM" ("Apple II to Mac"), to transfer the Single and Double Hi-Res 
images, captured with SoftSwitch and saved using the Screen Manager, 
directly to a Macintosh- The image is converted directly to a MacPaint 
document, and can then be placed direcdy into PageMaker, or the program 
of your choice. 



ATM is available from; 



Boojum Compute- Systems, Inc, 
15004 Doma Drive 
Silver Spring, MD 20904 

At the thm of this manual's widng, the price was about $50,00, but you 
should write the company for specific price and ordering infonnatioa 



Software Writers 

If you'm writing instructions, descriptions or articles for marines, your 
local newslettar or your classroom, SoftSwitch is a great way to switch hmk 
and forth between tte program youVe writing about and the word processor 
you're writing the story with. If s like having thi^ computers side-by-side 
(except you don*t have to roll your chair around!). SoftSwitch lets you not 
have to renumber how a program worked - you can run the pro-am even 
as you're writing about it! 



Software Programming 

SoftSwitch can be used by programn^rs to quickly switch from a 
developn^nt progrmi such as the M^lin as^mbler, to the enviionmmt in 
which the progr^ is to be tested, for example die DeskTop or 
BASICSYSTEM, lUs eliniinates aU delays in shifting oivironmerits. In 
addition, because the con^Juter mvironment is completely swished, you 
don't have to worry about a program corrupriiig a source file still in 
memory, or a DOS pointer somewhere. 

If youVe got a program that runs for 20 minutes before a Img oa:urs, aiKl 
you want observe the "crash" several times, SoftSwitdi is an ideal miy to 
save the system state just befcro the cradi, and to repeat tte probl^ as 
inany tiines as MC^ary without having to re-run the entire prograr^ TTie 
fast switching also makes it voy conveniertt to switch \mk arri forth ard 
ccmpare memory poin^rs, variables, etc. before aiui aftex the problem 



Technical Support 



If your job involves helpk^ other u^rs of ^ftware p^kages, SoftS witch 
can provide a quick way of switching from om program to another, without 
having m wait for eadi program to boot up. You can also use it to allow 
;^u to vmk on your word processor and/or data base while waiting for the 
next queslioa Whm you need to start a program up, just put your letter or 
mailing list on hold, instantly switch to (or start via tl^ DeskTop) tfje 
program in question. When youte done, you're only a keypr^s away 
from being back where you left off before fl^ questioa 



Software Demonstrations 

If you demonstrate software for your us^ group, classroom, or in a i^tail 
setting, you can use Softswitch ^ setup all tte ptogmn^s youll be weding 
before the fact Then yon'U have instant acc^ to any program without 
having to was^ time etching tte disk spin to start iq) each new program. 
It conserves valuable time in demonstrations, and prevents impatience in 
your audience. 
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